产品简介
骑行实时最优匹配(N-1)服务主要目标是解决寻找最优车辆的问题,计算多辆车到达同一终点的距离矩阵,进行排序后筛选出来最优可接单的车辆。典型用法是,基于当前位置找周围的可接单车辆,进行派单。客户可以基于此服务给出的时间、距离、费用信息,再结合自己的业务场景,实现派单能力。
骑行实时最优匹配(N-1)服务支持计算距离/直线距离。单次请求N*1(N≤100个终点)。
骑行实时最优匹配(N-1)服务相比于骑行路线规划服务,可以再单次请求中得到更多的结果,且具有一次请求只记一次PV、QPS的优势。但是由于应用场景不同,此服务返回的内容也相对较少,只返回通行时间、里程、通行费用三个主要参数。
产品场景
解决骑行场景中多个起点,到同一终点的最优解问题。主要用于寻找最优可以接单的车辆。
请求地址
URL | https://tsapi.amap.com/v1/logistics/route/bicycle/matrix/multstart |
请求方式 | post |
特别注意:该接口是物流API服务收费接口,您如果申请试用或者正式应用都请通过工单系统提交商务合作类工单进行沟通。
请求参数
参数名 | 含义 | 规则说明 | 是否必须 | 缺省值 |
key | 请求服务权限标识 | 用户在高德地图官网申请Web服务API类型KEY | 必填 | 无 |
id | 任务请求的唯一标识 | 确保输入ID的唯一性, 推荐使用请求订单ID | 非必填 | 无 |
origins | 出发点 | lng,lat(经度在前;","分割;纬度在后)例如:117.500244,40.417801 经纬度建议小数点后不超过6位;格式为x,y ; x,y ; x,y.....。经纬度之间通过“;”分割;上限100个经纬度; | 必填 | 无 |
destination | 目的地 | lng,lat(经度在前;","分割;纬度在后)例如:117.500244,40.417801 经纬度建议小数点后不超过6位;格式为x,y。仅支持1个终点 | 必填 | 无 |
commuteMode | 行驶方式 | 行驶方式 0:直线距离 1:行驶距离 | 可选 | 1 |
vehicle | 车辆信息 | 0.步行 1.自行车 2.电动自行车 | 可选 | 2 |
返回结果
参数 | 类型 | 说明 |
errcode | string | 错误码 |
errmsg | string | 错误描述 |
errdetail | string | 错误详情 |
data | | |
| number | int | 根据输入顺序的起点/终点对排序 |
origin | string | lng,lat(经度在前;","分割;纬度在后)直接返回用户输入内容,格式为x,y。 |
destination | string | lng,lat(经度在前;","分割;纬度在后)直接返回用户输入内容,格式为x,y。 |
code | int | 是否计算成功 0:请求成功 3:请求起点不合法 4:请求终点不合法 6:请求不合法,不包括起终点错误 15:请求路径过长 -1:失败 -4:请求的路径返回数据过大 |
distance | int | 距离,单位:米 |
duration | int | 时间,单位:秒 注:行驶距离为直线距离(commuteMode=0), 此字段返回空 |
toll | int | 道路收费信息, 单位元 |