查询最新线路接口
Point-to-point支持:无需接入
接口概述
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": "找不到订单"
}