openydt-park

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

openydt-park — 车场信息域

openydt-park — Parking Lot Information Domain

CRITICAL:开始前 MUST 先用 Read 工具读取
../openydt-shared/SKILL.md
,掌握认证 / profile / 签名 / 状态码 / 限速 / 安全规则后再执行任何
openydt park
命令。
CRITICAL: MUST use the Read tool to read
../openydt-shared/SKILL.md
before starting
. Master authentication / profile / signature / status code / rate limit / security rules before executing any
openydt park
commands.

何时用本技能

When to Use This Skill

当用户的诉求落在「停车场静态/动态信息」上时使用本域,例如:
  • 查停车场:列出授权商所有车场、看单个车场的基本信息 / 系统信息 / 区域 / 通道 / 云车场设备。
  • 查车位:单个车场空车位、区域内(按经纬度半径)空车位、单个车场实时剩余车位、剩余车位 + 免费时长。
  • 查费 / 计费:根据车场编码取收费信息(查费)、对某收费标准做其他车型计费测算。
  • 车辆相关:车辆免费停车信息、车辆屏显及语音、车辆优惠券(电子券)记录。
  • 授权 / 维护:取该账号下所有授权车场编码;设置(上报)车场实时车位(写操作)。
意图路由:
  • 涉及「订单/账单/缴费/月票」→ 用
    openydt trade
  • 涉及「在场车/进出场/锁车/放行」→ 用
    openydt parking
  • 涉及「黑/白名单、访客、电子券核销、设备」→ 分别用
    openydt blacklist
    /
    openydt redlist
    /
    openydt visitor
    /
    openydt coupon
    /
    openydt device
  • 「车场本身的属性、车位、车场维度查费」→ 留在本域
    openydt park
本域以查询为主、无强依赖链:各查询命令大多只需要
parkCode
(停车场编号),可独立调用。仅
get-park-ydt-other-car-type-charge-info
需要先调用查费命令拿到结果对象后回填(见业务流程)。
Use this domain when users' requests are related to "static/dynamic parking lot information", such as:
  • Query parking lots: List all parking lots of the authorized provider, view basic information / system information / areas / channels / cloud parking lot equipment of a single parking lot.
  • Query parking spaces: Empty parking spaces in a single parking lot, empty parking spaces within an area (by longitude and latitude radius), real-time remaining parking spaces in a single parking lot, remaining parking spaces + free parking duration.
  • Fee inquiry / calculation: Obtain fee information based on parking lot code (fee inquiry), calculate fees for other vehicle types according to a certain charging standard.
  • Vehicle-related: Free parking information for vehicles, vehicle display and voice prompts, vehicle coupon (e-coupon) records.
  • Authorization / maintenance: Obtain all authorized parking lot codes under the account; set (report) real-time parking spaces of the parking lot (write operation).
Intent Routing:
  • Related to "orders/bills/payment/monthly tickets" → Use
    openydt trade
    .
  • Related to "vehicles on site/entry and exit/lock/unlock" → Use
    openydt parking
    .
  • Related to "black/white lists, visitors, e-coupon redemption, equipment" → Use
    openydt blacklist
    /
    openydt redlist
    /
    openydt visitor
    /
    openydt coupon
    /
    openydt device
    respectively.
  • "Parking lot attributes, parking spaces, fee inquiry at parking lot level" → Stay in this domain
    openydt park
    .
This domain is query-focused with no strong dependency chain: Most query commands only require
parkCode
(parking lot code) and can be called independently. Only
get-park-ydt-other-car-type-charge-info
requires calling the fee inquiry command first to obtain the result object and then filling it back (see Business Process).

可用命令

Available Commands

<use>
为命令真实 kebab 名,调用形如
openydt park <use>
。所有命令支持
--body '<json>'
直接传完整请求体;列出的字段也提供同名 flag(flag 会合并覆盖
--body
)。
中文名命令读/写关键参数
获取授权商所有停车场信息
openydt park get-park-list
(无)
获取该账号下所有授权车场编码
openydt park get-auth-park-codes
(无)
获取停车场全部信息
openydt park get-all-park-info
--park-code
--update-time-from
--update-time-to
(均可选)
获取单个停车场基本信息
openydt park get-park-info
--park-code
(可选)
获取停车场系统信息(VEMS/云车场)
openydt park get-park-system-info
--park-code
(可选)
获取车场区域信息
openydt park get-park-area-info
--park-code
*
获取云停车场通道信息
openydt park get-channel-info
--park-code
*
获取云停车场设备信息
openydt park get-cloud-park-device-info
--park-code
*
获取单个停车场空车位信息
openydt park get-ept
--park-code
*
获取区域内所有停车场空车位信息
openydt park get-area-ept
--longitude
--latitude
--radius
*
获取单个停车场实时车位信息
openydt park get-park-remain-carport
--park-code
*、
--area-code
--area-id
获取停车场剩余车位和免费时长
openydt park get-park-remain-carport-and-free-time
parkCodes
*(车场编号数组,用
--body
根据车场编码获取收费信息(查费)
openydt park get-park-ydt-charge
--park-code
*、
--start-date-time
其他车型计费测算
openydt park get-park-ydt-other-car-type-charge-info
--park-code
--standard-seq
--car-type
--start-time
parkYdtChargeVo
*(用
--body
获取车辆免费停车信息
openydt park get-car-free-parking-info
--park-code
--parking-code
--car-code
--vip-type
--is-support-special-charge-rule
--is-support-trigger-event
获取车辆屏显及语音
openydt park get-display-voice-by-car-code
--park-code
--car-code
--vip-type
channelCodeList
(用
--body
)、
--feature-pass-time
--whether-charge
获取车辆优惠券信息列表
openydt park get-car-coupon-record
--page-num
--page-size
carPlateList
*(车牌列表,用
--body
设置停车场实时车位信息
openydt park set-park-remain-carport
写(需
--yes
--park-code
remainCarportList
(区域车位数组,用
--body
备注:标
*
为必填。
carPlateList
/
channelCodeList
/
parkCodes
/
parkYdtChargeVo
/
remainCarportList
等数组/对象型字段没有独立 flag,需通过
--body
JSON 传入。适用场景:标注「云停车场」的命令(区域、通道、云车场设备、查费、计费测算、设置车位)仅对云车场有效,其余 VEMS 传统车场与云车场通用。
<use>
is the actual kebab-case name of the command, called in the form
openydt park <use>
. All commands support
--body '<json>'
to directly pass the complete request body; the listed fields also provide flags with the same name (flags will merge and override
--body
).
Chinese NameCommandRead/WriteKey Parameters
Get All Parking Lot Information of Authorized Provider
openydt park get-park-list
Read(None)
Get All Authorized Parking Lot Codes Under the Account
openydt park get-auth-park-codes
Read(None)
Get Complete Parking Lot Information
openydt park get-all-park-info
Read
--park-code
,
--update-time-from
,
--update-time-to
(all optional)
Get Basic Information of a Single Parking Lot
openydt park get-park-info
Read
--park-code
(optional)
Get Parking Lot System Information (VEMS/Cloud Parking Lot)
openydt park get-park-system-info
Read
--park-code
(optional)
Get Parking Lot Area Information
openydt park get-park-area-info
Read
--park-code
*
Get Cloud Parking Lot Channel Information
openydt park get-channel-info
Read
--park-code
*
Get Cloud Parking Lot Equipment Information
openydt park get-cloud-park-device-info
Read
--park-code
*
Get Empty Parking Space Information of a Single Parking Lot
openydt park get-ept
Read
--park-code
*
Get Empty Parking Space Information of All Parking Lots in an Area
openydt park get-area-ept
Read
--longitude
,
--latitude
,
--radius
*
Get Real-time Parking Space Information of a Single Parking Lot
openydt park get-park-remain-carport
Read
--park-code
*,
--area-code
,
--area-id
Get Remaining Parking Spaces and Free Duration of Parking Lot
openydt park get-park-remain-carport-and-free-time
Read
parkCodes
* (array of parking lot codes, use
--body
)
Obtain Fee Information by Parking Lot Code (Fee Inquiry)
openydt park get-park-ydt-charge
Read
--park-code
*,
--start-date-time
Fee Calculation for Other Vehicle Types
openydt park get-park-ydt-other-car-type-charge-info
Read
--park-code
,
--standard-seq
,
--car-type
,
--start-time
,
parkYdtChargeVo
* (use
--body
)
Get Free Parking Information of Vehicle
openydt park get-car-free-parking-info
Read
--park-code
,
--parking-code
,
--car-code
,
--vip-type
,
--is-support-special-charge-rule
,
--is-support-trigger-event
Get Vehicle Display and Voice Prompts
openydt park get-display-voice-by-car-code
Read
--park-code
,
--car-code
,
--vip-type
,
channelCodeList
(use
--body
),
--feature-pass-time
,
--whether-charge
Get Vehicle Coupon Information List
openydt park get-car-coupon-record
Read
--page-num
,
--page-size
,
carPlateList
* (array of license plates, use
--body
)
Set Real-time Parking Space Information of Parking Lot
openydt park set-park-remain-carport
Write (requires
--yes
)
--park-code
,
remainCarportList
(array of area parking spaces, use
--body
)
Note: Fields marked with
*
are required. Array/object-type fields such as
carPlateList
/
channelCodeList
/
parkCodes
/
parkYdtChargeVo
/
remainCarportList
do not have independent flags and must be passed via
--body
JSON. Application scenarios: Commands marked as "Cloud Parking Lot" (area, channel, cloud parking lot equipment, fee inquiry, fee calculation, set parking spaces) are only valid for cloud parking lots; other commands are applicable to both traditional VEMS parking lots and cloud parking lots.

业务流程

Business Process

查费 → 其他车型计费测算(唯一需要回填上一步响应的链路)

Fee Inquiry → Fee Calculation for Other Vehicle Types (the only link that requires filling back the previous step's response)

  1. 先查费:
    openydt park get-park-ydt-charge --park-code <parkCode>
    ,从响应中拿到查费信息对象(即
    parkYdtChargeVo
    ,含
    chargeTypeSeq
    /
    parkSysType
    /
    parkYdtChargeStandardVoList
    等,其中每个收费标准带有自增 ID
    standardSeq
    与车辆类型
    carType
    )。
  2. 再测算:把上一步整个查费返回结果作为
    parkYdtChargeVo
    字段、并指定要测算的
    standardSeq
    (收费标准 ID)、
    carType
    (计费规则的车辆类型,即「特殊车辆类型 ID」)、
    startTime
    (计费开始时间),调用:
    openydt park get-park-ydt-other-car-type-charge-info --body '{...}'
    • 强调:
      standardSeq
      carType
      parkYdtChargeVo
      必须取自上一步
      get-park-ydt-charge
      的响应字段,不可臆造。
其余命令均为独立查询:拿到
parkCode
(可先用
get-park-list
/
get-auth-park-codes
获取授权车场编码)后即可直接调用对应查询。
  1. First, perform fee inquiry:
    openydt park get-park-ydt-charge --park-code <parkCode>
    , obtain the fee inquiry information object (i.e.,
    parkYdtChargeVo
    , which includes
    chargeTypeSeq
    /
    parkSysType
    /
    parkYdtChargeStandardVoList
    , etc., where each charging standard has an auto-increment ID
    standardSeq
    and vehicle type
    carType
    ) from the response.
  2. Then, perform calculation: Use the entire fee inquiry result from the previous step as the
    parkYdtChargeVo
    field, specify the
    standardSeq
    (charging standard ID) to calculate,
    carType
    (vehicle type in the charging rule, i.e., "special vehicle type ID"), and
    startTime
    (fee calculation start time), then call:
    openydt park get-park-ydt-other-car-type-charge-info --body '{...}'
    • Emphasis:
      standardSeq
      ,
      carType
      , and
      parkYdtChargeVo
      must be obtained from the response fields of the previous
      get-park-ydt-charge
      command, and cannot be fabricated.
All other commands are independent queries: After obtaining
parkCode
(you can first use
get-park-list
/
get-auth-park-codes
to get authorized parking lot codes), you can directly call the corresponding query.

示例

Examples

  1. 列出账号下所有授权车场(无参数):
bash
openydt park get-park-list
  1. 查某车场的实时剩余车位(参数取自 catalog sampleBody):
bash
openydt park get-park-remain-carport --park-code 2KNTYVWC
  1. 按经纬度 + 半径查区域内所有车场空车位:
bash
openydt park get-area-ept --longitude 113.158978 --latitude 23.046084 --radius 200
  1. 写操作示例——设置车场实时车位(写操作必须加
    --yes
    确认
    ):
bash
openydt park set-park-remain-carport --yes --body '{
  "parkCode": "2KNTYVWC",
  "remainCarportList": [
    {"areaId": 1, "totalRemain": 1, "tempRemain": 1, "fixedRemain": 1}
  ]
}'
  1. List all authorized parking lots under the account (no parameters):
bash
openydt park get-park-list
  1. Query real-time remaining parking spaces of a certain parking lot (parameters taken from catalog sampleBody):
bash
openydt park get-park-remain-carport --park-code 2KNTYVWC
  1. Query empty parking spaces of all parking lots in an area by longitude + latitude + radius:
bash
openydt park get-area-ept --longitude 113.158978 --latitude 23.046084 --radius 200
  1. Write operation example — set real-time parking spaces of a parking lot (
    --yes
    must be added for confirmation in write operations
    ):
bash
openydt park set-park-remain-carport --yes --body '{
  "parkCode": "2KNTYVWC",
  "remainCarportList": [
    {"areaId": 1, "totalRemain": 1, "tempRemain": 1, "fixedRemain": 1}
  ]
}'