获取当前订单的司机的位置
此接口用于司机接单后,合作方获取接单司机位置和实时距离等司机信息展示给用户,目前realtimeDistance近程单为01003返回是的直线距离,预计到达时间不支持
建议合作方在app一直开启情况下10S轮询一次,或者根据合作方实际情况调用
方法名
| Uri |
请求方式 |
| driver/position |
GET |
参数说明
| 参数 |
是否必须 |
说明 |
备注 |
| token |
是 |
用户凭证 |
|
| bookingId |
是 |
预约id |
|
| driverId |
是 |
司机工号 |
|
| orderId |
是 |
订单id |
下多单需要多次调用 |
| gpsType |
否 |
坐标类型 |
baidu、wgs84、google等,默认 baidu |
| pollingCount |
是 |
拉取次数 |
返回值说明
| 值 |
说明 |
备注 |
| code |
返回状态码 |
0成功、非0失败 |
| message |
返回状态说明 |
|
| data |
返回数据集合 |
|
| next |
下次请求间隔时间 |
单位:秒 |
| driver |
返回司机信息集合 |
|
| cancelType |
取消类型 |
401系统取消、402客户取消、405司机拒绝取消 |
| recommandBeginTime |
皇冠开始时间 |
|
| waitTime |
等候时间 |
单位:分钟(不带单位) |
| state |
司机状态 |
1在线、2忙碌、3下线 |
| orderStateCode |
订单状态码 |
|
| customerLat |
客户纬度 |
实时更新 |
| customerLng |
客户经度 |
实时更新 |
| distance |
距离 |
废弃 |
| realtimeDistance |
实时距离 |
米,(直线距离,不带单位) |
| name |
司机姓名 |
|
| driverId |
司机工号 |
|
| role |
角色 |
组长、组员 |
| longitude |
经度 |
|
| latitude |
纬度 |
|
| year |
驾龄 |
|
| pictureSmall |
司机头像 |
小图 尺寸 120*144 |
| orderId |
订单ID |
|
| newLevel |
星级 |
1-5 |
| domicile |
籍贯 |
|
| orderState |
订单状态 |
101:派单中 201:派单中 301:已接单 302:已就位 303:已开车304:代驾结束 403:用户取消 404:司机销单 501:司机报单 |
| recommandEndTime |
皇冠结束时间 |
拥有皇冠的结束时间 |
| recommandBeginTime |
皇冠开始时间 |
拥有皇冠的开始时间 |
| goback |
结伴返程标识 |
0不返城、1返城 |
| recommend |
是否皇冠 |
0非皇冠司机、1皇冠司机 |
| orderAllStates |
返回订单状态数据集合 |
|
| orderStateContent |
订单状态描述 |
|
| orderStateCode |
订单状态码 |
|
| orderStateTimestamp |
订单状态时间 |
|
| pollingCount |
拉取次数 |
|
| timeout |
超时时间 |
单位:秒 |
| bonusSn |
优惠券号码 |
|
| bonusMoney |
优惠券金额 |
|
| couponInfo |
优惠券信息json |
包含所有优惠券信息 |
成功返回值
{
"code": 0,
"data": {
"driver": {
"driverId": "zz13032",
"name": "李涛",
"gender": "男",
"cityId": 18,
"year": "9",
"state": "1",
"domicile": "河南",
"newLevel": "5.00",
"recommand": 0,
"goback": "0",
"serviceTimes": "111",
"distance": "1米",
"longitude": "113.688101",
"latitude": "34.629468",
"pictureSmall": "https:\/\/edjpic.edaijia.cn\/drivericon\/2019\/04\/f2\/01\/42aead5933c17aa2c49ca4e69095db54.jpgSmall",
"dispatchOrderFilterDistance": 7000,
"serviceType": "00000000000000000000000000000001",
"phone": "17737157316",
"idcard": "4107111979******17",
"recommandBeginTime": 0,
"recommandEndTime": 0,
"isJinpai": false,
"locationStart": "锦艺城购物中心",
"locationEnd": "",
"payStatus": 0,
"cashOnly": 0,
"waitTime": 1,
"cancelType": "",
"role": "组员",
"orderAllStates": [{
"orderStateCode": "303",
"orderStateTimestamp": 1561970510,
"orderStateContent": "开车行驶"
}, {
"orderStateCode": "302",
"orderStateTimestamp": 1561970403,
"orderStateContent": "司机已到达 等候1分"
}, {
"orderStateCode": "301",
"orderStateTimestamp": 1561968513,
"orderStateContent": "司机已接单"
}],
"orderId": "186555547",
"orderStateCode": "303",
"orderState": "已开车",
"fee": "",
"matches": 1,
"source": "0",
"channel": "01003",
"bonusChange": true,
"customerLng": "113.619163",
"customerLat": "34.767387",
"payChannel": 1,
"onlinePayStatus": -1,
"payFee": 0,
"isFromH5": true,
"realtimeDistance": 16598,
"virtualPhone": 0,
"bonusSn": "",
"bonusMoney": 0,
"couponInfo": []
},
"next": 10,
"pollingCount": "1",
"timeout": 600
},
"message": "成功"
}