浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

WEB 服务API

百度地图Web服务API为开发者提供http/https接口,即开发者通过http/https形式发起检索请求,获取返回json或xml格式的检索数据。用户可以基于此开发JavaScript、C#、C++、Java等语言的地图应用。

服务介绍
服务文档
使用指南
常见问题
更新日志
批量算路服务 v2.0
批量算路服务(又名Route Matrix API)是一套以HTTP/HTTPS形式提供的轻量级批量算路接口,用户可通过该服务,根据起点和终点,返回路线规划距离和行驶时间。
功能介绍
批量算路

根据起点和终点,批量计算路线的距离和耗时
可选择出行方案(驾车、骑行、步行)
融入出行策略(不走高速、常规路线、距离较短)
步行时任意起终点之间的距离不得超过200KM,超过此限制会返回参数错误
一次最多计算50条路线,起终点个数之积不能超过50。 比如2个起点25个终点,50个起点1个终点等

ntom.png

适用场景

适用于高并发场景,如网约车派单、物流配送派单场景,同时发起多个起终点之间的算路,筛选所需要的订单起终点

接口功能文档
服务地址-驾车
http://api.map.baidu.com/routematrix/v2/driving?
https://api.map.baidu.com/routematrix/v2/driving?
服务地址-骑行
http://api.map.baidu.com/routematrix/v2/riding?
https://api.map.baidu.com/routematrix/v2/riding?
服务地址-步行
http://api.map.baidu.com/routematrix/v2/walking?
https://api.map.baidu.com/routematrix/v2/walking?
示例URL
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
请求参数
参数名称 参数含义 类型 是否必填
ak 用户的ak string
origins 起点坐标串。坐标格式为:纬度,经度|纬度,经度。
示例:40.056878,116.30815|40.063597,116.364973
string
destinations 终点坐标串 string
tactics 算路偏好,该参数只对驾车算路(driving)生效。 该服务为满足性能需求,不含道路阻断信息干预。
可选值:

10: 不走高速;

11:常规路线,即多数人常走的一条路线,不受路况影响;

12: 距离较短(考虑路况):即距离相对较短的一条路线,但并不一定是一条优质路线。计算耗时时,考虑路况对耗时的影响;

13: 距离较短(不考虑路况):路线同以上,但计算耗时时,不考虑路况对耗时的影响,可理解为在路况完全通畅时预计耗时。 
注:除13外,其他tactics 的耗时计算都考虑实时路况

string 否,默认为13:最短距离(不考虑路况)
gps_direction 起点的车头方向,取与正北方向夹角,取值范围:0-359。该参数只对驾车算路(driving)生效,用于辅助判断起点所在正逆向车道,提高算路准确率。 当speed>1.5m/s且gps_direction存在时,采用该方向。gps_direction并不代表需填写从gps获取的方向,可以填入校正后的方向。请填写尽量准确的方向,其准确性很大程度决定了计算的精度。 int64
radius 起点的定位精度,由GPS或定位SDK返回,配合gps_direction字段使用 float
speed 起点车辆的行驶速度,该字段只对驾车算路(driving)生效。配合gps_direction字段使用,当speed>1.5m/s且gps_direction存在时,采用gps_direction的方向。 float
output 表示输出类型,可设置为xml或json string 否,默认为xml
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


使用方法
坐标系说明
WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标
RouteMatrix API v2.0的输入参数支持以上三种坐标系,开发者无需进行任何坐标转换,只需通过输入参数"coord_type"指明所使用的坐标系即可。
注意事项
该服务不支持sn校验方式,请使用IP白名单校验方式。
本接口不支持回调。
服务配额

每个开发者账号每天调用“批量算路”API 服务的总次数(即配额)是有限的。

每个开发者账号每分钟调用“批量算路”API 服务的总次数(即并发量)是有限的。

若需要更高配额和并发量,请申请开发者认证以获取更高配额和更及时的技术支持(若已认证,请通过API控制台-我的服务自行申请配额)。
同一个账号下的HTTP/HTTPS请求,配额,并发共享。

请注意:
1、Routematrix配额是按最终路线计算次数,而非Routematrix请求数。
2、一次最多计算50条路线,起终点个数之积不能超过50。比如2个起点25个终点,50个起点1个终点等。

配额及默认并发量说明如下
分类 未认证 个人认证 企业认证
日配额(次) 2,000 30,000 300,000
分钟并发数(次/分钟) 1,200 3,000 12,000
编码说明
API请求中需要用到中文或一些特殊字符的参数,如query、region等,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成UTF-8字符的二字符十六进制值,凡是不在下表中的字符都需要进行编码。
字符集合 字符
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保留字
 ! * ' ( ) ; : @ & = + $ , / ? % # [ ]
如果中文参数中使用URL保留字字符的字面意思,例如:region关键字取值为"?北京",检索关键字包含一个问号,此问号也必须进行编码。

附注:

javascript中一般采用encodeURIComponent函数对特殊字符进行编码。

Java中可以使用函数URLEncoder.encode对特殊字符进行编码。

C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。

php中可以使用函数urlencode对特殊字符进行编码。

服务常见问题
1、批量算路API的使用配额/并发满了要怎么办?

批量算路API服务与其他API服务一样,具有每天使用配额和并发次数的限制。如果您的使用配额或并发不能满足业务使用需求,可以通过认证个人/企业开发者的方式,提升配额。如果您已经是企业认证开发者,配额/并发依然不够使用,可在API控制台-我的服务中申请做进一步提升,请详细填写日配额和并发预估计算方法,以便评估。

2、批量请求,配额如何计算?

批量请求配额是按最终路线计算次数,而非Routematrix请求数。如1个起点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)模式,新增输入起点车头方向功能。该功能通过行驶的车头方向、车行速度、定位精度三个字段辅助判断起点所在道路的正逆向(例如:在道路的南向北方向),从而实现更准确的算路,支持网约车等行业实现更精准的司机到达时间和距离计算。