获取当前订单的司机的位置
此接口用于司机接单后,合作方获取接单司机位置和实时距离等司机信息展示给用户,目前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": "成功"
}