openydt-data

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

CRITICAL：开始前 MUST 先用 Read 工具读取
../openydt-shared/SKILL.md
（认证 / profile / 签名 / 状态码 / 限速 / 安全规则），否则命令会因缺少凭证或签名而失败。

CRITICAL: MUST use the Read tool to read
../openydt-shared/SKILL.md
before starting (Authentication / Profile / Signature / Status Codes / Rate Limiting / Security Rules), otherwise the command will fail due to missing credentials or signatures.

何时用本技能

When to Use This Skill

当用户需要对停车场做只读数据分析与报表统计时使用本技能，例如：查某车场的缴费账单 / 账单汇总、看车流量与车牌 top 分布、读停车场实时在场数据、统计当天出车次数与交易次数、按分钟看车流曲线、分析车位使用情况（含 echart 热力图）、做停车时长分布分析。

意图路由：

要账单/缴费明细 →
```
get-bill-summary
```
；要账单汇总指标 →
```
get-park-bill
```
。
要车流量曲线/趋势 → 整段每分钟用
```
get-traffic-flow
```
；车牌 top 分布用
```
get-car-traffic-flow-analysis
```
。
要实时/当天数据 → 实时在场用
```
get-real-time-park-info
```
；当天出车与交易次数用
```
get-realtime-leave-and-charge-num
```
。
要车位使用情况 → 列表数据用
```
parking-place-used
```
；绘 echart 热力图用
```
parking-place-used-for-echart
```
。
要停车时长分布 →
```
parking-time-analyse
```
。
若要发起缴费、查车场配置、月票/券、设备、黑白名单、访客等，不属于本域，请改用对应技能（trade / parking / ticket / coupon / device / blacklist / redlist / visitor 等）。

Use this skill when users need to perform read-only data analysis and report statistics for parking lots, such as checking payment bills/bill summaries of a parking lot, viewing traffic flow and top license plate distribution, reading real-time present data of parking lots, counting daily vehicle exit counts and transaction counts, viewing traffic flow curves by minute, analyzing parking space usage (including echart heatmaps), and conducting parking duration distribution analysis.

Intent Routing:

For bills/payment details →
```
get-bill-summary
```
; for bill summary indicators →
```
get-park-bill
```
.
For traffic flow curves/trends → Use
```
get-traffic-flow
```
for per-minute data over a period; use
```
get-car-traffic-flow-analysis
```
for top license plate distribution.
For real-time/daily data → Use
```
get-real-time-park-info
```
for real-time present data; use
```
get-realtime-leave-and-charge-num
```
for daily vehicle exit and transaction counts.
For parking space usage → Use
```
parking-place-used
```
for list data; use
```
parking-place-used-for-echart
```
to generate echart heatmaps.
For parking duration distribution →
```
parking-time-analyse
```
.
If users need to initiate payment, check parking lot configurations, monthly tickets/coupons, devices, blacklists/whitelists, visitors, etc., these do not belong to this domain, please use corresponding skills (trade / parking / ticket / coupon / device / blacklist / redlist / visitor, etc.).

可用命令

Available Commands

中文名	命令	读/写	关键参数
获取某停车场缴费账单信息	`openydt data get-bill-summary`	读	parkCode, dimension(0天/1月/2年/3自定义), startTime, endTime, pageNum, pageSize
获取车流量车牌top分布	`openydt data get-car-traffic-flow-analysis`	读	parkCodeList(停车场编码列表 JSONArray)
查询某车场账单汇总信息	`openydt data get-park-bill`	读	parkCode, dimension(0天/1月/2年), startTime, endTime, pageNum, pageSize
获取停车场实时数据	`openydt data get-real-time-park-info`	读	parkCode
获取车场当天的出车次数、交易次数	`openydt data get-realtime-leave-and-charge-num`	读	parkCode
获取单个停车场每分钟车流量情况	`openydt data get-traffic-flow`	读	parkCode, startTime, endTime(间隔≤1天，格式 yyyy-MM-dd HH:mm)
获取车位使用情况数据	`openydt data parking-place-used`	写(需 `--yes` )	parkCode, startDate, endDate(yyyyMMddHHmmss), minuteInterval(10 或 240)
获取车位使用情况数据(echart热力图)	`openydt data parking-place-used-for-echart`	写(需 `--yes` )	parkCode, startDate, endDate(yyyyMMddHHmmss), minuteInterval(10 或 240)
获取车场停车时长分析数据	`openydt data parking-time-analyse`	写(需 `--yes` )	parkCode, startDate, endDate(yyyyMMddHHmmss), vipType(1临时车/2月租车), hourArea

说明：
parking-place-used
、
parking-place-used-for-echart
、
parking-time-analyse
在平台契约里标记为 write，调用时必须带
--yes
确认，否则会被写操作确认拦截。其余命令均为只读，无需
--yes
。

Chinese Name	Command	Read/Write	Key Parameters
Get payment bill information of a parking lot	`openydt data get-bill-summary`	Read	parkCode, dimension(0 day/1 month/2 year/3 custom), startTime, endTime, pageNum, pageSize
Get top license plate distribution of traffic flow	`openydt data get-car-traffic-flow-analysis`	Read	parkCodeList(JSONArray of parking lot codes)
Query bill summary information of a parking lot	`openydt data get-park-bill`	Read	parkCode, dimension(0 day/1 month/2 year), startTime, endTime, pageNum, pageSize
Get real-time parking lot data	`openydt data get-real-time-park-info`	Read	parkCode
Get daily vehicle exit counts and transaction counts of a parking lot	`openydt data get-realtime-leave-and-charge-num`	Read	parkCode
Get per-minute traffic flow of a single parking lot	`openydt data get-traffic-flow`	Read	parkCode, startTime, endTime(interval ≤ 1 day, format yyyy-MM-dd HH:mm)
Get parking space usage data	`openydt data parking-place-used`	Write(requires `--yes` )	parkCode, startDate, endDate(yyyyMMddHHmmss), minuteInterval(10 or 240)
Get parking space usage data (echart heatmap)	`openydt data parking-place-used-for-echart`	Write(requires `--yes` )	parkCode, startDate, endDate(yyyyMMddHHmmss), minuteInterval(10 or 240)
Get parking duration analysis data of a parking lot	`openydt data parking-time-analyse`	Write(requires `--yes` )	parkCode, startDate, endDate(yyyyMMddHHmmss), vipType(1 temporary vehicle/2 monthly rental vehicle), hourArea

Note:
parking-place-used
,
parking-place-used-for-echart
, and
parking-time-analyse
are marked as write in the platform contract. Must include
--yes
for confirmation when calling, otherwise they will be intercepted by the write operation confirmation. Other commands are read-only and do not require
--yes
.

业务流程

Business Process

数据分析域均为车场维度的只读/统计查询，核心入参是

parkCode

（停车场编号/编码）。典型分析链路如下，强调用前序命令响应里的字段作为后续命令入参：

确定目标车场 parkCode：
```
parkCode
```
来自车场域命令（如
```
openydt park
```
/
```
openydt parking
```
列表/查询接口）的响应字段，或来自用户/上游系统。先拿到 parkCode，再把它填入本域所有命令的
--park-code
。
快速体检（实时面）：用
```
get-real-time-park-info
```
（实时在场/车位）+
```
get-realtime-leave-and-charge-num
```
（当天出车次数、交易次数）拿到当天概览，确认车场有数据、编号正确。
车流分析：
- 单场分钟级曲线：
```
get-traffic-flow
```
  ，注意
```
startTime
```
  /
```
endTime
```
  间隔不允许超过一天（格式
```
yyyy-MM-dd HH:mm
```
  ）。
- 多场车牌 top 分布：
```
get-car-traffic-flow-analysis
```
  ，把多个车场的
```
parkCode
```
  组成
```
parkCodeList
```
  数组传入。
账单分析：先用
```
get-park-bill
```
看账单汇总指标（按 dimension 选天/月/年），需要逐条明细时再用
```
get-bill-summary
```
（dimension 支持 3 自定义时间段），两者均分页（
```
pageNum
```
/
```
pageSize
```
，pageSize 最多 1000 条）。
车位与时长分析（写确认，需
--yes
）：
- 车位使用情况：
```
parking-place-used
```
  （列表）/
```
parking-place-used-for-echart
```
  （热力图坐标数据），
```
minuteInterval
```
  仅支持 10 或 240。
- 停车时长分布：
```
parking-time-analyse
```
  ，按
```
vipType
```
  （1 临时车 / 2 月租车）和
```
hourArea
```
  时长区间（形如
```
0-1,1-4,4-7,7-10,10-12,12-0
```
  ）切分。
- 上述命令的时间参数用
```
yyyyMMddHHmmss
```
  紧凑格式，与第 3/4 步的
```
yyyy-MM-dd
```
  格式不同，注意区分。

字段传递要点：上游车场域响应中的
parkCode
→ 本域全部命令的
--park-code
；分页查询响应里的总数/分页信息 → 调整下一次的
--page-num
/
--page-size
；多场分析时把各车场
parkCode
收集进
--body
的
parkCodeList
数组。

All operations in the Data Analysis Domain are parking lot-level read-only/statistical queries, with the core parameter being

parkCode

(parking lot ID/code). A typical analysis process is as follows, emphasizing using fields from the response of previous commands as parameters for subsequent commands:

Determine the target parking lot parkCode:
```
parkCode
```
comes from response fields of parking lot domain commands (such as
```
openydt park
```
/
```
openydt parking
```
list/query interfaces), or from users/upstream systems. Obtain parkCode first, then fill it into
--park-code
of all commands in this domain.
Quick Health Check (Real-time Overview): Use
```
get-real-time-park-info
```
(real-time present vehicles/parking spaces) +
```
get-realtime-leave-and-charge-num
```
(daily vehicle exit counts, transaction counts) to get the daily overview, confirm that the parking lot has data and the code is correct.
Traffic Flow Analysis:
- Per-minute curve for a single parking lot:
```
get-traffic-flow
```
  , note that the interval between
```
startTime
```
  /
```
endTime
```
  cannot exceed one day (format
```
yyyy-MM-dd HH:mm
```
  ).
- Top license plate distribution for multiple parking lots:
```
get-car-traffic-flow-analysis
```
  , pass multiple parking lot
```
parkCode
```
  as a
```
parkCodeList
```
  array.
Bill Analysis: First use
```
get-park-bill
```
to view bill summary indicators (select day/month/year by dimension), then use
```
get-bill-summary
```
(dimension supports 3 custom time periods) when itemized details are needed. Both support pagination (
```
pageNum
```
/
```
pageSize
```
, maximum pageSize is 1000 entries).
Parking Space and Duration Analysis (Requires Write Confirmation, Needs
--yes
):
- Parking space usage:
```
parking-place-used
```
  (list) /
```
parking-place-used-for-echart
```
  (heatmap coordinate data),
```
minuteInterval
```
  only supports 10 or 240.
- Parking duration distribution:
```
parking-time-analyse
```
  , split by
```
vipType
```
  (1 temporary vehicle / 2 monthly rental vehicle) and
```
hourArea
```
  duration intervals (in the format like
```
0-1,1-4,4-7,7-10,10-12,12-0
```
  ).
- The time parameters of the above commands use the compact format
```
yyyyMMddHHmmss
```
  , which is different from the
```
yyyy-MM-dd
```
  format in steps 3/4, please note the distinction.

Key Points for Field Transfer:
parkCode
from upstream parking lot domain responses →
--park-code
of all commands in this domain; total count/pagination information from pagination query responses → adjust
--page-num
/
--page-size
for the next query; collect
parkCode
of each parking lot into the
parkCodeList
array in
--body
for multi-parking-lot analysis.

示例

Examples

bash

undefined

bash

undefined

1) 查询某车场账单汇总（按年维度，只读，无需 --yes）

1) Query bill summary of a parking lot (year dimension, read-only, no --yes required)

openydt data get-park-bill
--park-code 2KKN6112 --dimension 2
--start-time "2019-08-17 00:00:00" --end-time "2019-08-17 23:59:59"
--page-num 1 --page-size 10

2) 获取车流量车牌 top 分布（多场，用 --body 传 parkCodeList 数组，只读）

2) Get top license plate distribution of traffic flow (multiple parking lots, pass parkCodeList array via --body, read-only)

openydt data get-car-traffic-flow-analysis
--body '{"parkCodeList":["765OB49GJ","765MQK2TX"]}'

3) 获取车场停车时长分析数据（write 操作，必须带 --yes）

3) Get parking duration analysis data of a parking lot (write operation, must include --yes)

openydt data parking-time-analyse
--park-code 2KKN885S
--start-date 20190910000000 --end-date 20190910235959
--vip-type 1 --hour-area "0-1,1-4,4-7,7-10,10-12,12-0"
--yes

undefined

openydt data parking-time-analyse
--park-code 2KKN885S
--start-date 20190910000000 --end-date 20190910235959
--vip-type 1 --hour-area "0-1,1-4,4-7,7-10,10-12,12-0"
--yes

undefined