批量算路服务的配额和并发是按最终路线数来计算,而非RouteMatrix API请求数。如一次请求2个起点5个终点,则最终路线输出为2*5=10条,配额计为10次。
批量算路目前支持驾车、摩托车、骑行(电动车/自行车)、步行。
根据起点和终点,批量计算路线的距离和耗时
融入出行策略(不走高速、常规路线、距离较短),路线和耗时计算考虑实时路况
驾车模式支持输入起点车头方向,提升准确性
步行时任意起终点之间的距离不得超过200KM,超过此限制会返回参数错误
一次最多计算50条路线,起终点个数之积不能超过50。 比如2个起点25个终点,50个起点1个终点等
适用于高并发场景,如网约车派单、物流配送派单场景,同时发起多个起终点之间的算路,筛选所需要的订单起终点
摩托车批量算路为开放平台高级服务,需申请开通权限后才能访问服务
http://api.map.baidu.com/routematrix/v2/motorcycle? //GET请求
https://api.map.baidu.com/routematrix/v2/motorcycle? //GET请求
http://api.map.baidu.com/routematrix/v2/driving? //GET请求
https://api.map.baidu.com/routematrix/v2/driving? //GET请求
http://api.map.baidu.com/routematrix/v2/riding? //GET请求
https://api.map.baidu.com/routematrix/v2/riding? //GET请求
http://api.map.baidu.com/routematrix/v2/walking? //GET请求
https://api.map.baidu.com/routematrix/v2/walking? //GET请求
http://api.map.baidu.com/routematrix/v2/driving?output=json&origins=40.45,116.34|40.54,116.35&destinations=40.34,116.45|40.35,116.46&ak=您的AK //GET请求
参数名称 | 参数含义 | 类型 | 是否必填 |
---|---|---|---|
ak | 用户的AK | string | 是 |
origins | 纬度,经度。示例:40.056878,116.30815|40.063597,116.364973 【步骑行、摩托车】支持传入起点uid提升绑路准确性,格式为:纬度,经度;POI的uid|纬度,经度;POI的uid。示例:40.056878,116.30815;xxxxx|40.063597,116.364973;xxxxx |
string | 是 |
destinations | 纬度,经度。示例:40.056878,116.30815|40.063597,116.364973 【步骑行、摩托车】支持传入终点uid提升绑路准确性,格式为:纬度,经度;POI的uid|纬度,经度;POI的uid。示例:40.056878,116.30815;xxxxx|40.063597,116.364973;xxxxx |
string | 是 |
tactics |
驾车、摩托车可设置,其他无需设置。该服务为满足性能需求,不含道路阻断信息干预。 驾车偏好选择,可选值如下: 摩托车偏好选择,可选值如下: |
string | 否,默认为13:最短距离(不考虑路况) |
riding_type | 电动车、自行车骑行可设置,其他无需设置。骑行类型,筛选普通自行车、电动自行车骑行 可选值:0 普通自行车 1 电动自行车 |
string | 否,默认为0 |
output | 表示输出类型,可设置为xml或json。 | string | 否,默认为json |
coord_type | 坐标类型,可选值为:bd09ll(百度经纬度坐标)、bd09mc(百度墨卡托坐标)、gcj02(国测局加密坐标)、wgs84(gps设备获取的坐标)。 | string | 否,默认为bd09ll |
参数名 | 参数含义 | 类型 | 备注 | ||
---|---|---|---|---|---|
status | 状态码 | int |
0:成功 1:服务器内部错误 2:参数错误 | ||
message | 返回信息 | string | 对status的中文描述 | ||
result | 返回的结果 | array | 数组形式。数组中的每个元素代表一个起点和一个终点的检索结果。顺序依次为(以2起点2终点为例):
origin1-destination1, origin1-destination2, origin2-destination1, origin2-destination2 | ||
|
distance |
路线距离 | |
| |
|
text | 线路距离的文本描述 | string | 文本描述的单位有米、公里两种 | |
|
value | 线路距离的数值 | double | 数值的单位为米。若没有计算结果,值为0 | |
duration |
路线耗时 | |
| ||
|
text | 路线耗时的文本描述 | string | 文本描述的单位有分钟、小时两种 | |
value | 路线耗时的数值 | double | 数值的单位为秒。若没有计算结果,值为0 |
GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标。
RouteMatrix API v2.0的输入参数支持以上三种坐标系,开发者无需进行任何坐标转换,只需通过输入参数"coord_type"指明所使用的坐标系即可。
本接口不支持回调。
服务相关配额及并发请求限制请访问开发者权益页面查看。
字符集合 | 字符 |
URL非保留字 |
a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~ |
URL保留字 |
! * ' ( ) ; : @ & = + $ , / ? % # [ ] |
附注:
Javascript中一般采用EncodeURIComponent函数对特殊字符进行编码。
Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
Php中可以使用函数Urlencode对特殊字符进行编码。
RouteMatrix API服务与其他API服务一样,具有每天使用配额和并发次数的限制。如果您的使用配额或并发不能满足业务使用需求,可以通过认证个人/企业开发者的方式,提升配额。如果您已经是企业认证开发者,配额/并发依然不够使用,可在API控制台-我的服务中申请做进一步提升,请详细填写日配额和并发预估计算方法,以便评估。
批量请求配额是按最终路线计算次数,而非RouteMatrix API请求数。如2个起点5个终点,则最终路线输出为2*5=10条,配额计为10次。
2013年12月19日
V1.0
2016年6月27日
V2.0
2018年6月11日
V2.1
提供同时查询多个起终点线路信息的数据接口。
1、提供最多50条路线距离和时间的计算。
2、起终点个数由原来的分别不超过5个,调整为起终点乘积不超过50。
3、新增骑行模式。
4、起终点输入仅支持坐标,不再支持输入关键字。
5、其他调整,详见接口说明。
对于驾车(driving)模式,新增输入起点车头方向功能。该功能通过行驶的车头方向、车行速度、定位精度三个字段辅助判断起点所在道路的正逆向(例如:在道路的南向北方向),从而实现更准确的算路,支持网约车等行业实现更精准的司机到达时间和距离计算。