司机接送驾路线上报
接口说明
- 将首约侧司机接驾或送驾路线通过回调方式上报给渠道
- 接口验签方式采用向渠道方推送订单状态、账单信息等同样的算法
- 司机接送驾路线上报: 1.司机出发后接驾路线会上报, 2.司机服务开始时送驾路线会上报, 3.司机结束服务后送驾路线会上报, 4.中间接送驾路线发生变化后均会上报
接口地址
https:// <Partner_DOMAIN>/<CallBackURL>
请求方式
POST + Form
请求参数
| 参数名称 |
类型 |
必选 |
说明 |
| orderNo |
string |
Y |
首约订单号 |
| partnerOrderNo |
string |
Y |
合作方订单号 |
| eventTime |
long |
Y |
上报导航时刻时间戳 |
| expiredTime |
long |
Y |
请求过期时间戳 |
| eventId |
string |
Y |
事件id，唯一标识 |
| sign |
string |
Y |
请求签名 |
| channel |
string |
Y |
首汽标识：shouqi |
| driverLocation |
jsonObject |
Y |
上报导航时刻司机位置 |
| status |
Integer |
Y |
导航上报状态，1 首次上报;2 中途上报;3 最终上报(接驾完成后上报) |
| routeData |
jsonObject |
N |
导航路径，将routeData数据转为json格式，具体见下面routeData类型 |
| routeType |
Integer |
N |
接送驾标识，1 送驾; 空或其他值 接驾 |
driverLocation类型
| 参数名称 |
类型 |
必选 |
说明 |
| driverId |
Integer |
Y |
司机id |
| location |
string |
Y |
经纬度，如116.5173486328125,39.77426839192708 |
| driverTimeStamp |
string |
Y |
坐标点采集时间 单位：毫秒 |
| driverDirection |
double |
Y |
车头方向 [0,360) ,0表示正北，顺时针 |
routeData类型
| 参数名称 |
类型 |
必选 |
说明 |
| routeLength |
Integer |
Y |
司机当前位置距目的地的距离 单位：米，status=3时不传 |
| routeTime |
Integer |
Y |
司机当前位置距目的地的时间 单位：秒，status=3时不传 |
| coordList |
string |
Y |
路线所有点（经纬度），status=3时不传，例：121.388767,31.246757;121.389414,31.247860; |
| trafficList |
list |
Y |
路况，status=3时不传 |
| trafficList.level |
Integer |
Y |
路况类型 0未知状态，1畅通，2缓行，3阻塞，4严重拥堵 |
| trafficList.index |
list |
Y |
路况对应的段 |
返回结果
| 名称 |
类型 |
说明 |
| result |
string |
0:成功；非0 :失败原因编号 |
| errmsg |
string |
失败原因描述，若成功值可为空 |
请求示例
{
"eventId": "5a3b188391c94d75b3393787a68d6838",
"driverLocation": {
"driverId": 1563520,
"location": "114.469547,22.728151",
"driverDirection": 291.11063,
"driverTimeStamp": 1677482198210
},
"orderNo": "BZ230227135818051003021",
"partnerOrderNo": "16300800305006",
"routeData": {
"trafficList": [{
"level": 1,
"index": [0, 1]
},
{
"level": 1,
"index": [1, 10]
}],
"routeLength": 6074,
"routeTime": 780,
"coordList": "114.450621,22.702552;114.451094,22.702313;"
},
"eventTime": 1677482198,
"channel": "shouqi",
"sign": "82db73835765b5738bed01aab355984a",
"routeType": 1,
"expiredTime": 1677482498,
"status": 3
}