开发 物流服务API 开发指南 物流矩阵服务 物流长途距离计算矩阵(M-N)

物流长途距离计算矩阵(M-N) 最后更新时间: 2022年10月18日

产品简介

       长途距离测量矩阵(M-N)服务,是物流1-N、N-1服务的高级服务,服务主要适配物流全局最优调度场景, 大批量长距离车货仓调度线路信息,进而计算最优全局调度组合。开发者可以在此数据的基础上,结合自己的业务数据,进行最优路径的计算和调度。 该服务批量计算了从M个起点,到N个终点的所有组合距离矩阵,支持填写车辆信息,规避限行/限重/限高/限宽,支持货车/客车行车距离距离,返回了通行时间、里程、通行费用三个主要参数。单次请求M*N的乘积不超过200。        该服务由于运算量较大,是个异步接口,分为创建任务服务、查询任务服务两个接口。一般情况下,计算结果可以在数秒内完成。

接口文档

1. 创建任务

API URL

URL

https://tsapi.amap.com/v1/logistics/route/longmatrix/add

请求方式

POST

特别注意:该接口是物流API服务收费接口,您如果申请试用或者正式应用都请通过工单系统提交商务合作类工单进行沟通。

请求:

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

用户在高德地图官网申请Web服务API类型KEY

必填

id

任务请求的唯一标识

确保输入ID的唯一性, 推荐使用请求订单ID(string)

非必填

origins

出发点

lng,lat(经度在前;","分割;纬度在后)例如:117.500244,40.417801 经纬度建议小数点后不超过6位; 格式为x,y。格式为x,y ; x,y ; x,y.....。经纬度之间通过“;”分割;起终点乘机最多支持200(例:10个起点&20个终点)

必填

无 (小数点后大于6位, 进行截断处理)

destinations

目的地

lng,lat(经度在前;","分割;纬度在后)例如:117.500244,40.417801 经纬度建议小数点后不超过6位; 格式为x,y ; x,y ; x,y.....。经纬度之间通过“;”分割;起终点乘机最多支持200(例:10个起点&20个终点)

必填

无 (小数点后大于6位, 进行截断处理)

Strategy

路线规划策略 (新策略标识,与货车路线规划truck接口保持一致。)

取值定义(1-9与货车路线规划接口的Strategy保持一致): 

1:躲避拥堵 

2:不走高速 

3:避免收费 

4:躲避拥堵+不走高速 

5:避免收费+不走高速 

6:躲避拥堵+避免收费 

7:躲避拥堵+避免收费+不走高速 

8:高速优先 

9:躲避拥堵+高速优先 

11:默认策略(综合最优) 

20:距离优先 

21:距离优先,高速优先 

22:距离优先,不走高速 

23:距离优先,避免收费 

24. 距离优先,不走高速且避免收费;

可选

11

vehicle

车辆信息

接口说明传入vehicle才会有效果;

 vehicle包含车辆的 

1.    车辆类型(type), 默认货车,

2.    车牌号(plate),默认为空 

3.    车辆大小(size),默认轻型车, 小客车类型不生效, 

4.    车辆长度(length), 小客车类型不生效 

5.    车辆高度(height),小客车类型不生效 

6.    车辆宽度(width),小客车类型不生效, 

7.    车辆总重(weight),小客车类型不生效, 

8.    车辆载重(load),小客车类型不生效, 

9.    车辆轴数(axis),小客车类型不生效 

以上内容的vaule标准可查看附录1

非必传

restriction

规避限行

仅针对白名单用户生效, 如果非白名单用户 传入此字段, 统一按照不限行处理; 若使用此字段需要进行申请 是否开启规避限行 0.不规避限行(默认) 1.规避限行

可选

0

请求示例

curl -X POST \ 'https://tsapi.amap.com/v1/logistics/route/longmatrix/add?key=yourkey' \ -H 'content-type: application/json' \ -d '{ "origins":"121.487241,31.229493;121.487242,31.229493", "destinations":"121.47471,31.234484;121.460119,31.241676", "newStrategy":"11", "vehicle":{ "axis":"2", "plate":"苏A88V12", "type":"1", "size":"1", "length":"5.95", "height":"3.35", "width":"2.35", "weight":"4.495", "load":"1.5" } }'

返回:

参数 

说明 

errcode 

错误码

errmsg 

错误描述 

errdetail 

错误详情 

data

-jobId

返回计算任务ID, 通过此ID进行查询相关计算结果

返回示例

add接口返回参数,内容在data字段中,定义jobId,格式: { "errcode":"", "errmsg":"", "errdetail":"", "data":{ "jobId":"12345" } }

2. 查询任务

API URL

URL

https://tsapi.amap.com/v1/logistics/route/longmatrix/query

请求方式

GET

请求

key

请求服务权限标识

用户在高德地图官网申请Web服务API类型KEY

必填

jobId

任务请求的唯一标识

创建任务时返回ID

必填

返回

参数 

说明 

errcode 

错误码

errmsg 

错误描述 

errdetail 

错误详情 

data

/progress

(-1)-100 来表示进度,状态为100的时候返回data结果 1.    进行中任务: 返回进度状态 2.    完成任务: a.     「未处理」一个都没完成: 返回计算失败 b.    「超时」完成了一部分: 返回progress=-1(代表处理超时),  能够下载 c.     「完成」都完成: 返回progress=100, 能够下载

/resultAddress

返回处理之后结果地址, 具体内容参见下方字段

返回文件内容:

oss文件存储的是json数组,每个数组元素包括以下字段:

参数 

类型 

说明 

number

int

根据输入顺序的起点/终点对排序,从1开始。

origin

string

lng,lat(经度在前;","分割;纬度在后)直接返回用户输入内容 格式为x,y。

destination

string

lng,lat(经度在前;","分割;纬度在后)直接返回用户输入内容 格式为x,y。

code

int

是否计算成功 -1: 处理超时, 没有请求引擎的任务 0:请求成功 引擎code=0 其他数值:算路失败

distance

int

距离,单位:米

duration

int

时间,单位:秒

tolls

int

高速费用, 返回0即不收取

返回示例

{ "errcode": 10000, 

"errmsg": "OK", 

"errdetail": null,

 "data": { "progress": 100, "resultAddress": "http://oss/address" } 

OSS文件示例 

[ { "number":"1", 

"origin":"", 

"destination":"", 

"code":"", 

"distance":"122",

 "duration":"122" }, 

{ "number":"2", 

"origin":"", 

"destination":"", 

"code":"", 

"distance":"122", 

"duration":"122" }

 ]

3.     附录

附录1:车辆信息

Key

Key名称

value说明

plate

车牌

plate_number支持支持6位传统车牌和7位新能源车牌;例:plate_number:京XXXXXX; 当restriction=1的时候, 该字段必传

type

车辆类型

0:客车 1:货车(默认) 2:纯电动客车 3:纯电动货车 4:插电式混动客车 5:插电式混动货车

size

车辆大小

高德此分类依据国标 仅货车/纯电动货车/插电式混动货车类型生效 0:  微型车 1:轻型车(默认值) 2:中型车 3:重型车

length

车辆长度

仅货车/纯电动货车/插电式混动货车类型生效 单位米,取值[0 – 30]米,会严格按照填写数字进行限行规避,请按照车辆真实信息合理填写。

height

车辆高度

仅货车/纯电动货车/插电式混动货车类型生效 单位米,取值[0 – 10]米,会严格按照填写数字进行限行规避,请按照车辆真实信息合理填写。

width

车辆宽度

仅货车/纯电动货车/插电式混动货车类型生效 单位米,取值[0 – 10]米,会严格按照填写数字进行限行规避,请按照车辆真实信息合理填写。 

weight

车辆总重

仅货车/纯电动货车/插电式混动货车类型生效 单位吨,取值[0 – 200]吨,会严格按照填写数字进行限行规避,请按照车辆真实信息合理填写。 总重的含义是核定载重加上车辆自重的总质量。

load

车辆载重

仅货车/纯电动货车/插电式混动货车类型生效 单位吨,取值[0 – 200]吨,会严格按照填写数字进行限行规避,请按照车辆真实信息合理填写。 载重的含义是核定载重加上车辆自重的总质量。

axle

车辆轴数

仅货车/纯电动货车/插电式混动货车类型生效 单位个,取值[0 –50]个,会严格按照填写数字进行限行规避,请按照车辆真实信息合理填写。

返回顶部 示例中心 常见问题 智能客服 公众号
二维码