查询最新线路接口
接口概述
1、该接口用来在行程中查询轨迹数据并与客户同步，请按顺序返回预估点位
2、司机开始服务前，此接口需要返回去接乘客的轨迹，司机开始服务后，此接口需要返回预估行程的轨迹，如无，可返回空列表
3、调用时机，在司机接单后会调用一次，在司机开始服务后会调用一次，其余会在供应商通知路径变更回调接口后调用一次
4、性能要求：供应商需要在200ms内响应结果。
请求地址
地址格式: {Domain}/{Channel}/driverroutequery/2.0/{timeStamp}/{sign}
请求内容
QueryDriverRouteRequest
| 参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
| ctripPurchaseOrderId |
Long |
是 |
携程采购单号 |
881823967638342968 |
18位 |
| vendorOrderId |
String |
是 |
供应商订单id |
|
返回内容
QueryDriverRouteResponse
| 参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
| msgCode |
String |
是 |
响应码 |
OK |
响应码 |
| message |
String |
否 |
响应详情 |
成功 |
响应码 |
| driverLocationInfo |
List<DriverLocationDTO> |
是 |
司机点位列表 |
|
|
| estimateDistance |
Integer |
是 |
剩余里程 |
16000 |
单位：米 |
| estimateTime |
Integer |
是 |
剩余时间 |
1200 |
单位：秒 |
DriverLocationDTO
| 参数 |
类型 |
必传 |
描述 |
示例 |
备注 |
| longitude |
BigDecimal |
是 |
经度 |
119.192474 |
精确到小数点后6位，不足6位补0 |
| latitude |
BigDecimal |
是 |
纬度 |
26.051053 |
精确到小数点后6位，不足6位补0 |
| coordinate |
String |
是 |
坐标系类型 |
GCJ02 |
0 GCJ02 高德坐标系（火星坐标系）; 1 BD09 百度坐标系; 2 WGS84 谷歌坐标系（大地坐标系） |
请求示例
{
"ctripPurchaseOrderId": 4295005950734823,
"vendorOrderId": "2022022022"
}
响应示例
{
"driverLocationInfo":[
{
"longitude":120.146755,
"latitude":30.326975,
"coordinate":"WGS84"
},
{
"longitude":109.416225,
"latitude":18.315702,
"coordinate":"WGS84"
}
],
"msgCode":"OK",
"message":"成功",
"estimateDistance":16000,
"estimateTime":1200
}
异常示例
{
"msgCode": "ERROR_NO_ORDERID",
"message": "找不到订单"
}