开发 物流服务API 开发指南 骑行&摩托车服务 骑行实时最优匹配N-1

骑行实时最优匹配N-1 最后更新时间: 2024年12月03日

产品简介

​骑行实时最优匹配(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

道路收费信息, 单位元

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