上报导航
接口说明: 合作方通过该接口上报导航轨迹
接口提供方: 美团
请求地址: https://{$domain}/api/open/callback/common/partner/lbs/navigation/update
服务协议: HTTPS/POST
请求参数:
参数名称 | 类型 | 必选 | 说明 |
---|---|---|---|
mtOrderId | string | 是 | 美团订单号 |
partnerOrderId | string | 是 | 合作方订单号 |
time | long | 是 | 上报导航时刻时间戳 |
routeType | int | 是 | 0-接驾 1-送驾 |
eventType | string | 是 | 导航事件类型,四种:FirstRoute初始导航线路,ReRoute偏航后重新规划的线路,OffRoute偏航事件,Arrive到达目的地 |
loc | string | 是 | 上报导航时刻司机位置。需要传送json格式 |
loc.longitude | double | 是 | 经度保留小数点后6位,如117.500244,经度小数点不超过6位 |
loc.latitude | double | 是 | 纬度保留小数点后6位,如40.417801,纬度小数点不超过6位 |
loc.timeStamp | double | 是 | 坐标点采集时间单位:毫秒 |
loc.direction | double | 是 | 车头方向[0,360),0表示正北,顺时针 |
data | string | 是 | 导航路径,将Data类型数据转为json格式,具体见下面Data类型,eventType是FirstRoute和ReRoute时不为空,eventType是OffRoute和Arrive时为空 |
data.distance | int | 是 | 距离 单位:米 |
data.duration | int | 是 | 预估时间 单位:分钟 |
data.polyline | string | 是 | 经纬度,例:121.388767,31.246757;121.389414,31.247860; |
data.roadConditions | list | 是 | 路况 |
data.roadConditions.level | int | 是 | 路况距离 0:未知 1:通畅 2:缓行 3:拥堵 4:严重拥堵 |
data.roadConditions.polyline_idx | list | 是 | 路况对应的段 |
plateNumber | string | 否 | 车牌号 |
{
"loc":"{\"direction\":261.02,\"latitude\":37.840455,\"longitude\":112.571533,\"timeStamp\":1510199534507}",
"eventType": "FirstRoute",
"data":"{\"distance\":1000,\"duration\":15,\"polyline\":\"121.388767,31.246757;121.389414,31.247860;121.389583,31.248142;121.389826,31.248554;121.390073,31.248962\",\"roadConditions\":[{\"level\":1,\"polyline_idx\":[0,2]},{\"level\":2,\"polyline_idx\":[2,4]}]}",
"time": "1510199534000",
"mtOrderId": "00002121212121211",
"partnerOrderId": "00002121212121211",
"plateNumber": "京AXXXX"
}
返回参数
参数名称 | 类型 | 必选 | 说明 |
---|---|---|---|
code | int | 是 | 返回0表示成功,非0表示失败 |
message | string | 是 | 成功: SUCCESS, 失败:具体原因 |
{
"result": 0,
"message": "SUCCESS"
}