42 lines
1.6 KiB
Markdown
42 lines
1.6 KiB
Markdown
# 红绿灯信号接口文档
|
||
|
||
## 1. 上报接口定义
|
||
|
||
### 1.1 信号机实时状态上报
|
||
|
||
#### Topic
|
||
|
||
| Topic | cuse/v2/{tenantCode}/{deviceId}/data |
|
||
|-------|--------------------------------------|
|
||
| 消息发送方 | 设备 |
|
||
| 消息接收方 | 物联网平台 |
|
||
|
||
#### 参数说明
|
||
|
||
| 参数 | 必选/可选 | 类型 | 描述 |
|
||
|------|-----------|------|------|
|
||
| topic | 必选 | String | 设备参数上报固定为"deviceReq" |
|
||
| encryptFlag | 必选 | Short | 加密方式，0-不加密 1-AES128 加密 |
|
||
| serviceId | 必选 | String | 上报服务的标识 |
|
||
| reportTime | 必选 | Long | 设备参数上报时间 |
|
||
| serviceType | 必选 | String | 服务类型(设备上报数据类型) 固定值"ras-traffic-lights" |
|
||
| serviceData | 必选 | Object | 具体上报的数据集合，若采用 SM4 加密方式，则进行数据加密 |
|
||
|
||
#### serviceData
|
||
|
||
| 参数 | 必选/可选 | 类型 | 描述 |
|
||
|------|-----------|------|------|
|
||
| collectTime | 必选 | Long | 上报时间 |
|
||
| deviceSn | 可选 | String | 终端设备序列号 |
|
||
| deviceName | 可选 | String | 终端设备名称 |
|
||
| manufacturer | 可选 | String | 厂商编码 |
|
||
| modelName | 可选 | String | 设备类型名称 |
|
||
| trafficLightId | 必选 | String | 红绿灯设备 ID |
|
||
| signalStatus | 必选 | String | 信号灯状态 |
|
||
| longitude | 必选 | Double | 经度坐标，14位小数 |
|
||
| latitude | 必选 | Double | 纬度坐标，14位小数 |
|
||
| altitude | 必选 | Double | 海拔高度，6位小数 |
|
||
| areaId | 必选 | String | 信号机所处区域 ID |
|
||
| intersection | 必选 | String | 信号机所处路口名称 |
|
||
| generateTime | 必选 | Long | unix 时间戳 |
|