产品简介
物流距离测量矩阵（1-N）服务是解决物流场景中批量计算单起点至多终点的距离测量需求的服务，一般是以当前位置作为起点，计算到周围N个位置的时间、距离、费用，进而选择最优的终点。
物流距离测量矩阵（1-N）服务支持填写车辆信息，规避限行/限重/限高/限宽，支持货车/客车行车距离/直线距离。单次请求1*N（N≤100个终点）。
物流距离测量矩阵（1-N）服务相比于货车路线规划服务，可以再单次请求中得到更多的结果，且具有一次请求只记一次PV、QPS的优势。但是由于应用场景不同，此服务返回的内容也相对较少，只返回通行时间、里程、通行费用三个主要参数。
使用场景
所有的批量测距场景，适用于货运、零售等行业
例如：某个货运车辆想查看到周围所有合适的货场、加油站、维修站的距离。
请求地址
URL | https://tsapi.amap.com/v1/logistics/route/matrix |
请求方式 | POST |
特别注意：该接口是物流API服务收费接口，您如果申请试用或者正式应用都请通过工单系统提交商务合作类工单进行沟通。
请求参数
参数名 | 含义 | 规则说明 | 是否必须 | 缺省值 |
key | 请求服务权限标识 | 用户在高德地图官网申请Web服务API类型KEY | 必填 | 无 |
ID | 任务请求的唯一标识 | 确保输入ID的唯一性, 推荐使用请求订单ID | 必填 | 无 |
origin | 出发点 | lng,lat（经度在前;","分割；纬度在后）例如：117.500244,40.417801 经纬度建议小数点后不超过6位； | 必填 | 无 |
格式为x,y。 |
destinations | 目的地 | lng,lat（经度在前;","分割；纬度在后）例如：117.500244,40.417801 经纬度建议小数点后不超过6位； | 必填 | 无 |
格式为x,y ; x,y ; x,y.....。经纬度之间通过“;”分割；上限100个经纬度； |
newStrategy | 路线规划策略 （新策略标识，与货车路线规划truck接口保持一致。） | 取值定义（1-9与货车路线规划接口的Strategy保持一致）： | 可选 | 11 |
1：躲避拥堵 |
2：不走高速 |
3：避免收费 |
4：躲避拥堵+不走高速 |
5：避免收费+不走高速 |
6：躲避拥堵+避免收费 |
7：躲避拥堵+避免收费+不走高速 |
8：高速优先 |
9：躲避拥堵+高速优先 |
10：无路况+速度优先 |
11：默认策略（综合最优） |
12：无路况+不走高速（速度优先） |
20：距离优先 |
21：距离优先，高速优先 |
22：距离优先，不走高速 |
23：距离优先，避免收费 |
24. 距离优先，不走高速且避免收费； |
restriction | 规避限行 | 是否开启规避限行 | 可选 | 0 |
0.不规避限行 |
1.规避限行 |
commuteMode | 行驶方式 | 行驶方式 | 可选 | 1 |
0：直线距离 |
1：行驶距离 |
vehicle | 车辆信息（详见附录） | 当commuteMode=1时，传入vehicle才会有效果；vehicle包含车辆的 1. 车辆类型(type),0：客车，1：货车。 注意：vehicle为{}时 type会给默认值0，即默认客车；vehicle为null时会将vehicle默认为货车 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的时候, 该字段必传 |
|
请求示例
https://tsapi.amap.com/v1/logistics/route/matrix?key=xxxxx
{
"key": "xxxxx",
"origin": "118.755478,32.060347",
"destinations": "118.79393,32.0148;118.781399,31.998133;119.066357,32.056564;119.788021,31.345896",
"strategy": "24",
"restriction": "1",
"commuteMode": "1",
"vehicle": {
"plate": "京CZ3018",
"type": "1",
"size": "2",
"length": "2",
"height": "2",
"width": "2",
"load": "2",
"weight": "2",
"axis": "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:请求成功 2:算路失败 20:起点无效 40:终点无效 111:起点抓路失败 113:终点抓路失败 142:无法计算出有效路线 |
/distance | int | 距离,单位:米 |
/duration | int | 时间,单位:秒 注:行驶距离为直线距离(commuteMode=0), 此字段返回空 |
/toll | int | 道路收费信息, 单位元 |
/restriction | int | 限行信息, 仅开启规避限行策略才返回该字段; 0:可规避限行/不限行 1:不可规避限行 注:行驶距离为直线距离(commuteMode=0), 此字段返回空 |
附录：车辆信息
Key
| Key名称
| value说明
|
plate
| 车牌
| plate_number支持支持6位传统车牌和7位新能源车牌；例：plate_number:京XXXXXX；
当restriction=1的时候, 该字段必传
|
type
| 车辆类型
| 0：客车
1：货车(默认)
2：纯电动客车
3：纯电动货车
4：插电式混动客车
5：插电式混动货车
默认值:1
|
size
| 车辆大小
| 高德此分类依据国标
仅货车/纯电动货车/插电式混动货车类型生效
0: 微型车
1：轻型车（默认值）
2：中型车
3：重型车
|
length
| 车辆长度
| 仅货车/纯电动货车/插电式混动货车类型生效
单位米，取值[0 – 30]米，会严格按照填写数字进行限行规避，请按照车辆真实信息合理填写。
|
height
| 车辆高度
| 仅货车/纯电动货车/插电式混动货车类型生效
单位米，取值[0 – 10]米，会严格按照填写数字进行限行规避，请按照车辆真实信息合理填写。
|
width
| 车辆宽度
| 仅货车/纯电动货车/插电式混动货车类型生效
单位米，取值[0 – 10]米，会严格按照填写数字进行限行规避，请按照车辆真实信息合理填写。
|
weight
| 车辆总重
| 仅货车/纯电动货车/插电式混动货车类型生效
单位吨，取值[0 – 200]吨，会严格按照填写数字进行限行规避，请按照车辆真实信息合理填写。 总重的含义是核定载重加上车辆自重的总质量。
|
load
| 车辆载重
| 仅货车/纯电动货车/插电式混动货车类型生效
单位吨，取值[0 – 200]吨，会严格按照填写数字进行限行规避，请按照车辆真实信息合理填写。 载重的含义是核定载重加上车辆自重的总质量。
|
axis | 车辆轴数
| 仅货车/纯电动货车/插电式混动货车类型生效
单位个，取值[0 –50]个，会严格按照填写数字进行限行规避，请按照车辆真实信息合理填写。
|
