批量接驾计算 最后更新时间: 2021年01月22日
概述
一次计算多辆车路径规划信息, 结合车头方向,红绿灯,路口行为等网约车场景因素,精准返回车辆路径信息.
使用限制
需要申请批量接驾计算的服务&webservice-Key车辆位置同步权限,并通过webservice-Key上传车辆位置
适用平台
Webservice
适用场景
网约车行业,派单环节,需要进行一次性多个车辆的接驾距离、ETA计算,判断最优的接驾车辆.
使用限制
- 申请webserviceKey和批量接驾计算权限&车辆信息同步权限
- 保证调用Key同时同步空车车辆信息, 相关产品: 车辆信息同步
接入使用
接口URL:
http://tsapi.amap.com/V1/compute?key=#
1. 获取批量接驾计算结果
第一步,拼接HTTP请求URL,第一步申请的Key须作为参数一同传入;
第二部,接收HTTP请求返回的数据,解析数据.
简单示例
http://tsapi.amap.com/v1/compute?key=8248e5ccc8514b651e4a3706a023ce6b&orderID=001&radius=2&customerDeviceID=bb11d0c8-b22f-4183-9b46-45ef4b2734fe&vehicleType=0&orderCity=010&orderTime=1534222461&startTime=1534222461&startName=%E9%A6%96%E5%BC%80%E5%B9%BF%E5%9C%BA&start=116.4796417952,39.9943337896&endName=%E9%93%81%E9%81%93%E5%8D%9A%E7%89%A9%E9%A6%86&end=110.79393,32.0148&maxCount=200&needRelay=0
结果示例
{"data":{"count":2,"orderID":"001","vehicles":[{"costTime":81,"crossing":1,"dispatchOrder":1,"distance":406,"location":"116.479228735,39.9948516128","slDistance":67,"updateTime":1550474051000,"vehicleID":"1"},"errcode":10000,"errdetail":null,"errmsg":"OK"}
高级功能
功能1: 接力单场景
当派单的目标车辆增加了载人车时,可以利用此服务计算载人车的接驾距离、接驾ETA等信息,使用时需要设置对应的字段参数“needRelay”的值为1,则会返回符合筛选条件的载人车结果.
相关参数:
needRelay | 是否接受接力单 | int | 1-接受,0-不接受 | 必须 |
---|
请求示例
http://tsapi.amap.com/v1/compute?key=8248e5ccc8514b651e4a3706a023ce6b&orderID=001&radius=2&customerDeviceID=bb11d0c8-b22f-4183-9b46-45ef4b2734fe&vehicleType=0&orderCity=010&orderTime=1534222461&startTime=1534222461&startName=%E9%A6%96%E5%BC%80%E5%B9%BF%E5%9C%BA&start=116.4796417952,39.9943337896&endName=%E9%93%81%E9%81%93%E5%8D%9A%E7%89%A9%E9%A6%86&end=110.79393,32.0148&maxCount=200&needRelay=1
返回结果示例
{"data":{"count":2,"orderID":"001","vehicles":[{"costTime":81,"crossing":1,"dispatchOrder":1,"distance":406,"location":"116.479228735,39.9948516128","slDistance":67,"updateTime":1550474051000,"vehicleID":"1"},{"costTime":351,"crossing":4,"dispatchOrder":2,"distance":1191,"location":"116.473185,39.993253","pickupCrossing":2,"pickupDistance":715,"pickupTime":110,"slDistance":563,"tripCrossing":2,"tripDistance":476,"tripTime":181,"updateTime":1550474051000,"vehicleID":"2"}]},"errcode":10000,"errdetail":null,"errmsg":"OK"}
相关素材
车辆信息同步: 使用规范
批量接驾计算: 参考手册