123 lines
4.6 KiB
Markdown
123 lines
4.6 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
|
||
}
|