开发 物流服务API 开发指南 骑行&摩托车服务 骑行距离测量矩阵1-N

骑行距离测量矩阵1-N 最后更新时间: 2024年12月03日

产品简介

骑行距离测量矩阵(1-N)服务是解决配送场景中批量计算单起点至多终点的距离测量需求的服务,一般是以当前位置作为起点,计算到周围N个位置的时间、距离、费用,进而选择最优的终点。

​骑行车辆分为自行车、电动自行车两种,根据道路对于电动自行车禁限行上的区别,规划不同的行驶路线。

骑行距离测量矩阵(1-N)服务相比于骑行路线规划服务,可以再单次请求中得到更多的结果,且具有一次请求只记一次PV、QPS的优势。但是由于应用场景不同,此服务返回的内容也相对较少,只返回通行时间、里程、通行费用三个主要参数。

请求地址

URL

https://tsapi.amap.com/v1/logistics/route/bicycle/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个经纬度;

必填

commuteMode

行驶方式

行驶方式

0:直线距离

1:行驶距离

1

可选

vehicle

车辆信息

当commuteMode=1时,传入vehicle才会有效果;

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

道路收费信息, 单位元

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