产品简介
货车实时最优匹配（N-1）服务主要目标是解决寻找最优车辆的问题，计算多辆车到达同一终点的距离矩阵，进行排序后筛选出来最优可接单的车辆。典型用法是，乘客找周围的网约车时的派单。客户可以基于此服务给出的时间、距离、费用信息，再结合自己的业务场景，实现派单能力。
货车实时最优匹配（N-1）服务支持填写车辆信息，规避限行/限重/限高/限宽，支持货车/客车行车距离/直线距离。单次请求N*1（N≤100个终点）。
货车实时最优匹配（N-1）服务相比于货车路线规划服务，可以再单次请求中得到更多的结果，且具有一次请求只记一次PV、QPS的优势。但是由于应用场景不同，此服务返回的内容也相对较少，只返回通行时间、里程、通行费用三个主要参数。
产品场景
解决物流场景中多个起点，到同一终点的最优解问题。主要用于寻找最优可以接单的车辆。
产品功能
根据车辆信息规避限行, 批量计算小客车行车多对1行车距离/直线距离(最大支持100个起点)。
根据车辆信息,规避限行/限重/限高/限宽, 批量计算货车多对1行车距离/直线距离(最大支持100个起点)。
请求地址
URL | https://tsapi.amap.com/v1/logistics/route/matrix/multstart?key=<用户key> |
请求方式 | 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个终点 | 无 | 必填 |
newStrategy | 路线规划策略 （新策略标识，与货车路线规划truck接口保持一致。） | 取值定义（1-9与货车路线规划接口的Strategy保持一致）： 1：躲避拥堵 2：不走高速 3：避免收费 4：躲避拥堵+不走高速 5：避免收费+不走高速 6：躲避拥堵+避免收费 7：躲避拥堵+避免收费+不走高速 8：高速优先 9：躲避拥堵+高速优先 10：无路况+速度优先 11：默认策略（综合最优） 12：无路况+不走高速（速度优先） 20：距离优先 21：距离优先，高速优先 22：距离优先，不走高速 23：距离优先，避免收费 24. 距离优先，不走高速且避免收费； | 11 | 可选 |
restriction | 规避限行 | 是否开启规避限行 0.不规避限行 1.规避限行 | 0 | 可选 |
commuteMode | 行驶方式 | 行驶方式 0：直线距离 1：行驶距离 | 1 | 可选 |
vehicle | 车辆信息 | 当commuteMode=1时，传入vehicle才会有效果；vehicle包含车辆的 1.车辆类型(type),0：客车，1：货车，2：纯电动客车，3：纯电动货车，4：插电式混动客车，5：插电式混动货车。默认货车。 2.车牌号(plate),默认为空 3.车辆大小（size）,1：微型车，2：轻型车，3：中型车，4：重型车。默认轻型车, 小客车类型不生效 4.车辆长度(length), 单位：米，取值[0,30]米，默认5.0米。小客车类型不生效 5.车辆高度（height）, 单位：米，取值[0,10]米，默认2.0米。小客车类型不生效 6.车辆宽度（width）, 单位：米，取值[0,10]米，默认2.5米。小客车类型不生效。 7.车辆总重（weight）, 单位：吨，取值[0,200]吨，默认2.5吨。小客车类型不生效。 8.车辆载重（load）, 单位：吨，取值[0,200]吨，默认5吨。小客车类型不生效。 9.车辆轴数（axis）,默认2轴，小客车类型不生效 | | 当restriction=1的时候, 该字段必传 |
返回结果
参数 | 类型 | 说明 |
errcode | string | 错误码 |
errmsg | string | 错误描述 |
errdetail | string | 错误详情 |
data | | |
| number | int | 根据输入顺序的起点/终点对排序 |
origin | string | lng,lat（经度在前;","分割；纬度在后)直接返回用户输入内容，格式为x,y。 |
destination | string | lng,lat（经度在前;","分割；纬度在后）直接返回用户输入内容，格式为x,y。 |
code | int | 是否计算成功 0:请求成功 2:算路失败 20:起点无效 40:终点无效 111:起点抓路失败 113:终点抓路失败 142:无法计算出有效路线 |
distance | int | 距离,单位:米 |
duration | int | 时间,单位:秒 注:行驶距离为直线距离(commuteMode=0), 此字段返回空 |
toll | int | 道路收费信息, 单位元 |
restriction | int | 限行信息, 仅开启规避限行策略才返回该字段; 0:可规避限行/不限行 1:不可规避限行 注:行驶距离为直线距离(commuteMode=0), 此字段返回空 |
