您当前的位置: Web服务API > Route Matrix API v2.0
Route Matrix API v2.0

产品简介

Route Matrix API v2.0 Beta是一套以HTTP/HTTPS形式提供的批量算路接口,返回路线规划距离和行驶时间。


Route Matrix API v2.0 Beta是原v1.0接口的升级版,升级内容如下:

起终点个数由原来的分别不超过5个,调整为起终点乘积不超过50。

起终点输入仅支持坐标,不再支持输入关键字。

其他调整,详见接口说明。

坐标系说明

目前中国主要有以下三种坐标系:


① WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系


②GCJ02:表示经过国测局加密的坐标


③ BD09:为百度坐标系,其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标


RouteMatrix API v2.0的输入参数支持以上三种坐标系,开发者无需进行任何坐标转换,只需通过输入参数"coord_type"指明所使用的坐标系即可。

功能介绍

批量计算路线的距离和耗时

支持驾车、骑行和步行三种形式

步行时任意起终点之间的距离不得超过200KM,超过此限制会返回参数错误

一次最多计算50条路线,起终点个数之积不能超过50。 比如2个起点25个终点,50个起点1个终点等

ntom.png

配额限制

未认证开发者默认配额为:2000条路线/天(http和https共享配额,请注意:Route Matrix配额是按最终路线计算次数,而非Route Matrix请求数)

若需更高配额,请申请开发者认证以获取更高配额和更及时技术支持。

使用方法

第一步: 申请密钥(ak) ,作为访问服务的依据;

第二步:由于RouteMatrix v2是新服务,需要在API控制台中为ak启用该服务,才能使用,具体操作为:

1)进入API控制台,选择"应用列表",选择需要开通RouteMatrix API v2.0的ak,点击"设置"

selectAk.png

2)在『修改应用』界面中,勾选"RouteMatrix API"。点击"提交"后,即开通该AK的使用权限了。

chooseService.png

第三步:按照请求参数说明拼写发送http请求的url,注意需使用第一步申请的ak;

第四步:接收返回的数据(json或xml格式)。

注:本接口不支持回调。

请求URL

驾车

http://api.map.baidu.com/routematrix/v2/driving?

骑行

http://api.map.baidu.com/routematrix/v2/riding?

步行

http://api.map.baidu.com/routematrix/v2/walking?

请求接口参数

参数名称 是否必须 格式举例 参数含义
origins 必选

经纬度:40.056878, 116.30815|40.063597, 116.364973 坐标格式为:lat<纬度>,lng<经度>|lat<纬度>,lng<经度>

以"|"分割,最多传50个点,且起终点乘积不超过50
destinations 必选 同上 同上
output 选填,默认为xml json 表示输出类型,可设置为xml或json,默认为xml。
coord_type 选填,默认为bd09ll gcj02(国测局坐标,如google,soso地图均采用该坐标) 坐标类型,可选参数,默认为bd09ll。允许的值为:bd09ll(百度经纬度坐标)、bd09mc(百度摩卡托坐标)、gcj02(国测局加密坐标)、wgs84(gps设备获取的坐标)。
tactics 可选,默认为13:最短距离(不考虑路况) 12 只对驾车算路(driving)生效。  
可选值:

10: 不走高速;

11:常规路线,即多数人常走的一条路线,不受路况影响,可用于用车估价;

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

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

ak 必填 用户的ak 用户的访问权限
sn 选填 用户的权限签名
timestamp sn存在时必填 时间戳,与sn配合使用。

返回值说明

参数名 参数含义 类型 备注
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

接口示例

请求示例:

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

更新日志

2016年6月27日 Route Matrix APIv2.0发布。

产品上线:提供最多50条路线距离和时间的计算。

起终点个数由原来的分别不超过5个,调整为起终点乘积不超过50

新增骑行模式

起终点输入仅支持坐标,不再支持输入关键字

其他调整,详见接口说明


2013年12月19日 Route Matrix APIv1.0发布。

产品上线:提供同时查询多个起终点线路信息的数据接口。