226 lines
8.2 KiB
Markdown
226 lines
8.2 KiB
Markdown
# 数据接口对接方案
|
||
|
||
## 第1章 位置数据接口对接方案
|
||
|
||
### 1.1 登录认证
|
||
|
||
1. 登录接口：<http://IP:端口/login>
|
||
2. 请求方式：post
|
||
3. 参数：username、password
|
||
4. 示例：<http://127.0.0.1:8080/login?username=XXXX&password=XXXX>
|
||
5、返回值 data 为返回的鉴权token，后续接口需要再header中携带，data所有的数据是一个token，不要截断
|
||
示例：{
|
||
"status": 200,
|
||
"msg": "登入成功",
|
||
"data": "Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3MzI3ODMwOTAsInVzZXJuYW1lIjoiYWRtaW4ifQ.y9feEL_9NT8UzED9NNkb0Ln6C-PBoufiSHWobWe5vWY"
|
||
}
|
||
|
||
### 1.2 航空器位置数据接入
|
||
|
||
数据来源：接入并转发从空管接收到的融合数据
|
||
|
||
1. 接口地址：<http://IP:端口/openApi/getCurrentFlightPositions>
|
||
|
||
2. 请求方式：get，需要在 Header 中携带认证信息，字段名为 Authorization，值为认证接口返回的token
|
||
|
||
3. 返回格式：以 JSON 格式返回数据，一次请求返回List集合对象
|
||
|
||
4. 数据结构：
|
||
|
||
| 序号 | 字段 | 描述 | 字段类型 | 是否必填 |
|
||
|-----|------|------|----------|----------|
|
||
| 1 | flightNo | 航班号 | String | 是 |
|
||
| 2 | longitude | 经度 | double | 是 |
|
||
| 3 | latitude | 纬度 | double | 是 |
|
||
| 4 | time | 时间戳（UTC 时间） | long | 是 |
|
||
| 5 | altitude | 海拔高度 | double | 否 |
|
||
| 6 | trackNumber | 航迹号 | long | 否 |
|
||
|
||
### 1.3 车辆位置数据接入
|
||
|
||
数据来源：仅传递目前机场已接入的车辆位置数据
|
||
|
||
1. 接口地址：<http://IP:端口/openApi/getCurrentVehiclePositions>
|
||
|
||
2. 请求方式：get，需要在 Header 中携带认证信息，字段名为 Authorization，值为认证接口返回的token
|
||
|
||
3. 返回格式：以 JSON 格式返回数据，一次请求返回List集合对象
|
||
|
||
4. 数据结构：
|
||
|
||
| 序号 | 字段 | 描述 | 字段类型 | 是否必填 |
|
||
|-----|------|------|----------|----------|
|
||
| 1 | vehicleNo | 车牌号 | String | 是 |
|
||
| 2 | longitude | 经度 | double | 是 |
|
||
| 3 | latitude | 纬度 | double | 是 |
|
||
| 4 | time | 时间戳 | long | 是 |
|
||
| 5 | direction | 方向 | double | 否 |
|
||
| 6 | speed | 速度 | double | 否 |
|
||
|
||
## 第2章 无人车控制接口对接方案
|
||
|
||
### 2.1 无人车控制指令
|
||
|
||
2.1.1 接口地址: <http://127.0.0.1:31140/api/VehicleCommandInfo>
|
||
|
||
2.1.2 请求方法：POST
|
||
|
||
2.1.3 请求参数：
|
||
|
||
| 字段名称 | 类型 | 是否必填 | 说明 |
|
||
|---------|------|----------|------|
|
||
| transId | string | 是 | 消息唯一 id，消息的唯一标识符 |
|
||
| timestamp | long | 是 | 时间戳 |
|
||
| vehicleID | string | 是 | 车辆 ID |
|
||
| commandType | string | 是 | 指令类型：ALERT：告警指令，SIGNAL：信号灯指令，WARNING：预警指令，RESUME：恢复指令 |
|
||
| commandReason | string | 是 | 指令原因：TRAFFIC_LIGHT：红绿灯控制，AIRCRAFT_CROSSING：航空器交叉，SPECIAL_VEHICLE：特勤车辆，AIRCRAFT_PUSH：航空器推出，RESUME_TRAFFIC：恢复通行 |
|
||
| signalState | string | 否 | 信号灯状态（仅当 commandType 为 SIGNAL 时有效）RED：红灯，GREEN：绿灯，YELLOW：黄灯 |
|
||
| intersectionId | string | 否 | 路口 ID（仅当 commandType 为 SIGNAL 时有效） |
|
||
| latitude | double | 是 | 目标位置纬度（路口/航空器/特勤车） |
|
||
| longitude | double | 是 | 目标位置经度（路口/航空器/特勤车） |
|
||
| relativeSpeed | double | 否 | 相对速度（仅当 commandType 为 ALERT/WARNING 时有效） |
|
||
| relativeMotionX | double | 否 | 相对运动 X 分量（仅当 commandType 为 ALERT/WARNING 时有效） |
|
||
| relativeMotionY | double | 否 | 相对运动 Y 分量（仅当 commandType 为 ALERT/WARNING 时有效） |
|
||
| minDistance | double | 否 | 最小距离（仅当 commandType 为 ALERT/WARNING 时有效） |
|
||
|
||
示例：
|
||
|
||
requestData:
|
||
{
|
||
"messageUniqueId": "68f79d1a-e27f-11ed-b28c-2cf05d9c2649",
|
||
"timestamp": 1736175610000,
|
||
"vehicleID": "A001",
|
||
"commandType": "SIGNAL",
|
||
"commandReason": "TRAFFIC_LIGHT",
|
||
"signalState":"RED",
|
||
"intersectionId":"002",
|
||
"latitude": 343.23,
|
||
"longitude": 343.23,
|
||
"relativeSpeed": 3,
|
||
"relativeMotionX": 2002.12,
|
||
"relativeMotionY":100.12,
|
||
"minDistance":10.5
|
||
}
|
||
|
||
返回值：
|
||
|
||
| 字段名 | 类型 | 是否必须 | 描述 |
|
||
|---------|------|----------|------|
|
||
| transId | string | 是 | 消息唯一id，消息的唯一标识符与请求id一致 |
|
||
| timestamp | long | 是 | 时间戳 |
|
||
| code | int | 是 | 接口返回的状态码：200 请求成功：400 请求失败，并在msg内返回原因 |
|
||
| msg | string | 是 | 接口成功/失败的原因或者附加提示信息 |
|
||
|
||
示例：
|
||
|
||
responseData:
|
||
{
|
||
"code": 200,
|
||
"msg": "success",
|
||
"transId": "68f79d1a-e27f-11ed-b28c-2cf05d9c2649",
|
||
"timestamp": 1736175610
|
||
}
|
||
|
||
### 2.2 无人车位置上报
|
||
|
||
1. 接口地址: <http://127.0.0.1:31140/api/VehicleLocationInfo>
|
||
|
||
2. 请求方法：GET
|
||
|
||
3. 返回值（以 List 数据返回，一次请求返回集合对象）：
|
||
|
||
| 字段名称 | 类型 | 是否必填 | 说明 |
|
||
|---------|------|----------|------|
|
||
| transId | string | 是 | 消息唯一 id，消息的唯一标识符 |
|
||
| timestamp | long | 是 | 时间戳（UTC 时间，单位：毫秒） |
|
||
| vehicleID | string | 是 | 车辆 ID |
|
||
| latitude | double | 是 | 纬度 |
|
||
| longitude | double | 是 | 经度 |
|
||
| speed | double | 是 | 速度（单位：m/s） |
|
||
| direction | double | 是 | 车头航向角，正东为 0 度（弧度） |
|
||
|
||
示例：
|
||
|
||
requestData:
|
||
[
|
||
{
|
||
"transId": "68f79d1a-e27f-11ed-b28c-2cf05d9c2649",
|
||
"timestamp": 1736175610000,
|
||
"vehicleID": "AT001",
|
||
"latitude": 123.112,
|
||
"longitude": 78.331,
|
||
"speed": 3.2,
|
||
"direction": 1.57
|
||
}
|
||
]
|
||
|
||
### 2.3 无人车状态上报
|
||
|
||
1. 接口地址: <http://127.0.0.1:31140/api/VehicleStateInfo>
|
||
|
||
2. 请求方法：POST
|
||
|
||
3. 请求参数：
|
||
|
||
| 字段名称 | 类型 | 是否必填 | 说明 |
|
||
|---------|------|----------|------|
|
||
| transId | string | 是 | 消息唯一 id，消息的唯一标识符 |
|
||
| timestamp | long | 是 | 时间戳（UTC 时间，单位：毫秒） |
|
||
| vehicleID | string | 是 | 车辆 ID |
|
||
| isSingle | boolean | 是 | True：单个车辆，False：所有车辆 |
|
||
|
||
示例：
|
||
|
||
requestData:
|
||
{
|
||
"transId": "68f79d1a-e27f-11ed-b28c-2cf05d9c2649",
|
||
"timestamp": 1736175610000,
|
||
"vehicleID": "AT001",
|
||
"isSingle": true
|
||
}
|
||
|
||
4. 返回值（以 List 数据返回，一次请求返回集合对象）：
|
||
|
||
| 字段名称 | 类型 | 是否必填 | 说明 |
|
||
|---------|------|----------|------|
|
||
| transId | string | 是 | 消息唯一 id，消息的唯一标识符 |
|
||
| timestamp | long | 是 | 时间戳（UTC 时间，单位：毫秒） |
|
||
| vehicleID | string | 是 | 车辆 ID |
|
||
| loginState | boolean | 是 | 登录状态：True：登录，False：未登录 |
|
||
| faultInfo | list | 是 | 故障信息，以列表返回，可能存在多个 |
|
||
| activeSafety | boolean | 是 | 车辆最小风险策略触发（主动安全）：True：触发，False：未触发 |
|
||
| RC | boolean | 是 | 被接管或干预相关信息，是否被远控RemoteControl，True：车辆在遥控器远控模式，False：车辆处于自动驾驶模式 |
|
||
| Command | int | 是 | 接收的远程指令信息，0：恢复，1：急停，2：缓停 |
|
||
| airportInfo | list | 否 | 机场特殊要求的其他信息 |
|
||
| vehicleMode | int | 是 | 无人设备控制模式（底盘控制模式），1:手动（司机驾驶），2:自动，3:遥控器，4:远程，5：故障等待 |
|
||
| gearState | int | 是 | 车辆当前档位，1:N，2:D，3:P，4:R, 5: 未知 |
|
||
| chassisReady | boolean | 是 | 底盘是否准备就绪，True：车辆发控制指令就可以走，false: 其他 |
|
||
| collisionStatus | boolean | 否 | 防撞梁是否触发，true：触发，false：未触发 |
|
||
| clearance | int | 是 | 0：关闭，1：开启（示廓灯） |
|
||
| turnSignalStstus | int | 是 | 转向灯状态，0：off , 1 : trun left , 2 : trun right, 3: 双闪 |
|
||
| pointCloud | list | 否 | 点云数据字节流，每个点的长度，现在是12，每个坐标为float，长度4|
|
||
|
||
示例：
|
||
|
||
responseData:
|
||
[
|
||
{
|
||
"transId": "68f79d1a-e27f-11ed-b28c-2cf05d9c2649",
|
||
"timestamp": 1736175610000,
|
||
"vehicleID": "AT001",
|
||
"loginStatus":true,
|
||
"faultInfo":[],
|
||
"activeSafety":false,
|
||
"RC":false,
|
||
"Command":0,
|
||
"airportInfo":[],
|
||
"vehicleMode": 2,
|
||
"gearState": 2,
|
||
"chassisRaedy":true,
|
||
"collisionStatus":false,
|
||
"clearance":0,
|
||
"turnSignalStstus":0,
|
||
"pointCloud":[]
|
||
}
|
||
]
|