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

WEB 服务API

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

服务介绍
服务文档
使用指南
常见问题
更新日志
国际化路线规划服务 v1.0

国际化路线规划服务,支持中国港、澳、台,以及海外地区的出行路线规划服务能力。
线路规划方式上支持:驾车、公交、步行、骑行。
服务权限需申请开通海外服务权限。

功能介绍
支持多种出行方式

用户可通过该服务,根据起点和终点检索符合条件的出行路线规划方案。可选择出行方案(公交、驾车、步行),可融入出行策略(时间优先、距离优先等)

接口功能文档
驾车 - 国际化路线规划
http://api.map.baidu.com/direction_abroad/v1/driving?origin=40.702963,-73.907852&destination=40.625416,-73.960852&ak=您的ak
驾车 - 国际化路线规划 - 请求参数
字段名称 字段含义 备注
origin 起点经纬度,小数点后不超过6位,如“40.702963,-73.907852” 必填
destination 终点经纬度,小数点后不超过6位,如“40.625416,-73.960852” 必填
coord_type 输入的起终点坐标类型 可选,默认为bd09ll。允许的值为:
bd09ll(百度经纬度坐标);gcj02(国测局坐标);wgs84(gps 设备获取的坐标)。
ret_coordtype 返回结果坐标类型 可选,默认为bd09ll。允许的值为:
bd09ll(百度经纬度坐标)、gcj02(国测局坐标)
tactics 驾车策略 可选,默认为0。可选值为:


0:智能推荐
12:时间优先
13、距离优先
3、躲避拥堵
5、不走高速

output 表示输出类型 可选 json 或xml ,默认为json
ak 开发者密钥,ak申请 必填
sn 用户的权限签名,当ak设置为sn校验时,该参数必填
sn计算方法
选填
timestamp 时间戳,与sn配合使用 选填,sn存在时必填。
callback 回调函数,用于解决浏览器请求跨域问题 选填。仅在 output=json 时,该参数有效。
驾车 - 国际化路线规划 - 返回参数

 字段名称

描述

备注

status

状态码

0:成功
1:服务内部错误
2:参数无效;
7:无返回结果
3001:暂不支持该出行方式(此时说明不支持该国家的出行路线规划)

message

状态码对应的信息

 

type

返回数据类型

 

result

返回的结果

 

 

total

返回方案的总数

 

routes

返回的方案集

 

 

origin

lng

起点经度

 

lat

起点纬度

 

destination

lng

终点经度

 

lat

终点纬度

 

tag

方案标签

 

distance

方案距离,单位:米

 

duration

线路耗时,单位:秒

 

light_number

该路线的总红绿灯个数

 

steps

路线分段

 

 

instructions

分段的导航信息

 

direction

进入道路的角度。

枚举值,返回值在0-11之间的一个值,共12个枚举值,以30度递进,即每个值代表角度范围为30度;其中返回"0"代表345度到15度,以此类推,返回"11"代表315度到345度";分别代表的含义是:0-[345°-15°];1-[15°-45°];2-[45°-75°];3-[75°-105°];4-[105°-135°];5-[135°-165°];6-[165°-195°];7-[195°-225°];8-[225°-255°];9-[255°-285°];10-[285°-315°];11-[315°-345°]

distance

step的距离信息

单位米

turn

机动转向点,包括基准八个方向、环岛、分歧等

枚举值,返回0-16之间的一个值,共17个枚举值;分别代表的含义是:0-无效;1-直行;2-右前方转弯;3-右转;4-右后方转弯;5-掉头;6-左后方转弯;7-左转;8-左前方转弯;9-左侧;10-右侧;11-分歧-左;12-分歧中央;13-分歧右;14-环岛;15-进渡口;16-出渡口 注:都是右闭区间 未知 – 0 ;front: (338,21) – 1 ;right_front: (21,45) – 2 ;right: (45,135) – 3 ;right_back: (135, 175) – 4 ;back: (175,203) – 5 ;left_back: (203,235) – 6 ;left: (235,315) -7;left_front: (315,338) – 8

road_name

分段的道路名称

 

start_location

lng

分段起点经度

 

lat

分段起点纬度

 

end_location

lng

分段终点经度

 

lat

分段终点纬度

 

path

分段坐标

 

步行 - 国际化路线规划
http://api.map.baidu.com/direction_abroad/v1/walking?origin=40.702963,-73.907852&destination=40.625416,-73.960852&ak=您的ak
步行 - 国际化路线规划 - 请求参数

请求参数

字段含义

字段类型

是否必填

备注

origin

起点

"double,double"

1、起点经纬度,格式为:纬度,经度;小数点后不超过6位,40.702963,-73.907852

destination

终点

"double,double"

1、终点经纬度,格式为:纬度,经度;小数点后不超过6位,40.625416,-73.960852

coord_type

输入坐标类型

string

默认为bd09ll。允许的值为:bd09ll(百度经纬度坐标)、wgs84(gps设备获取的坐标)、、gcj02(国测局坐标)。

ret_coordtype

返回坐标类型

string

默认为百度经纬度坐标:bd09ll
可选值:
bd09ll:百度经纬度坐标 、gcj02(国测局坐标)

output

输出类型

string

否,默认为json

表示输出类型,可设置为xml或json,默认为json。

ak

骑行类型

string

开发者密钥

sn

开发者密钥

string

用户的权限签名

timestamp

时间戳,与sn配合使用

string

sn存在时必填

 

callback

回调函数,用于解决浏览器请求跨域问题

string

仅在 output=json 时,该参数有效。


步行 - 国际化路线规划 - 返回参数

返回字段

描述

备注

status

状态码

0:成功
1:服务内部错误
2:参数无效;
2001:无步行路线
3001:暂不支持该出行方式(此时说明不支持该国家的出行路线规划)

message

状态码对应的信息

例如 message:"ok"

type

类型

 

result

返回的结果

 

routes

返回的方案集

 

 

origin

lng

起点经度

 

lat

起点纬度

 

destination

lng

终点经度

 

lat

终点纬度

 

distance

方案距离

单位:米

duration

线路耗时

单位:秒

steps

direction

当前道路的方向角

 

distance

路段距离

单位:米

duration

路段耗时

单位:秒

instructions

路段描述

如“步行50米“

name

该路段道路名称

如“信息路“

path

路段位置坐标描述

 

turn_type

行驶转向方向

如“直行”、“左前方转弯”

stepOriginLocation

lng

路段起点经度

 

lat

路段起点纬度

 

stepDestinationLocation

lng

路段终点经度

 

lat

路段终点纬度

 


公交 - 国际化路线规划
http://api.map.baidu.com/direction_abroad/v1/transit?origin=40.702963,-73.907852&destination=40.625416,-73.960852&ak=您的ak
公交 - 国际化路线规划 - 请求参数

字段名称

字段含义

字段类型

备注

ak

开发者密钥

string

必填

sn

用户的权限签名

string

选填

timestamp

时间戳,与sn配合使用

string

选填,sn存在时必填

origin

起点

“double,double”

必填
经纬度模式,先纬度后经度小数点后不超过6位,“40.702963,-73.907852”

destination

终点

同上

同上

coord_type

输入坐标类型

string

可选,默认为bd09ll。允许的值为:
bd09ll(百度经纬度坐标); wgs84(gps 设备获取的坐标)、gcj02(国测局坐标)。

ret_coordtype

返回值的坐标类型

string

可选,默认为百度经纬度坐标:bd09ll
可选值: bd09ll:百度经纬度坐标、gcj02(国测局坐标)

tactics_incity

市内公交换乘策略

int(0-5)

可选,默认为0
0推荐;1少换乘;2少步行;3不坐地铁;4时间短;5地铁优先

departure_date

出发日期:

string

选填。可指定出发日期,如“20171030”
若不填,则默认为当天

departure_time

出发时间区间

 string

出发时间区间,格式为:
hh:mm,如”08:00” :表示只查询发车时间在8点至24点的方案

output

输出类型

string

可选 json或xml
默认为json

page_size

返回每页几条路线

int(1-10)

可选 默认为10返回所有可行routes的每页中含有几个routes

page_index

返回第几页

int

可选 默认为1 返回所有可行routes的第几页

callback

回调函数,用于解决浏览器请求跨域问题

string

选填。仅在 output=json 时,该参数有效。


公交 - 国际化路线规划 - 返回参数

字段名称

字段含义

字段类型

备注

status

状态码

int

0:成功
1:服务器内部错误
2:参数无效;
1001:没有公交方案
3001:暂不支持该出行方式(此时说明不支持该国家的出行路线规划)

message

状态码对应的信息

string

 

type

返回数据类型

int(1-2)

 

result

返回的结果

dict

 


result字段格式

字段名称

字段含义

字段类型

备注

origin

city_id

起点城市id

int

 

city_name

起点城市名称

string

 

location

lng

起点坐标的经度

double

 

lat

起点坐标的纬度

double

destination

city_id

终点城市id

int

 

city_name

终点城市名称

string

 

location

lng

终点坐标的经度

double

 

lat

终点坐标的纬度

double

total

所有路线的总数

 

符合条件的所有routes的总数

routes

每页page_size条,第page_index页的路线

array()

请求中指定的page_index和page_size的部分。数组元素个数为page_size,每个元素代表从起点到终点的一条路线。

 

distance

本条路线的总距离(米)

int

-1代表无结果

duration

本条路线的总耗时(秒)

int

-1代表无结果

arrive_time

本条路线预计到达时间

string

格式为2016-04-05 17:06:10

price

本条路线的总票价(元)

double

-1代表不支持票价

steps

本条路线有几个step(步骤)

array

数组,数组中的每一项是一步(step)。每条路线都由多个step组成
以国内路线举例说明,比如从奎科大厦到西直门分3个step,第一步是奎科大厦步行到上地五街,第二步是上地五街到上地地铁站,第三步是上地地铁站到西直门

 

schemes

本step中的有几个scheme(方案)

array

以国内路线举例说明,一个step中可能会有多个scheme(方案),上述同城的第二步上地五街到上地地铁站可以坐205或447,每一种是一个scheme

 

distance

本step的距离(米)

int

 

duration

本step的耗时(秒)

int

 

instructions

本step的描述

string

 

path

本step中的关键点坐标

string

“116.321858,40.039183;116.3216343,40.039141”

start_location

lng

本step起点经度

 

 

lat

本step起点纬度

 

 

end_location

lng

本step终点经度

 

 

lat

本step终点纬度

 

 

vehicle_info

type

本step中交通方式的类型

int

3 公交; 5步行;

detail

交通方式的具体信息

 

公交格式,参见下面的文档。步行为null


vehicle_info中type=3(公交)时detail字段格式:

字段名称

字段含义

字段类型

备注

name

公交线路名称

string

 

type

市内公交的具体类型

int

只有同城公交才会有此字段
0:普通日行公交车;1:地铁、轻轨; 2:机场巴士(前往机场); 3:有轨电车; 4:机场巴士(从机场返回); 5:旅游线路车; 6:夜班车; 7:机场巴士(机场之间); 8:轮渡; 9:其他; 10:快车; 11:慢车;12:机场快轨(前往机场); 13:机场快轨(从机场返回);14:机场轨道交通环路

stop_num

途径站点数

int

 

on_station

上车站点名称

string

 

off_station

下车站点名称

string

 

first_time

始发车发车时间

string

指的是从上车站点到下车站点这个方向上的始发车发车时间

last_time

末班车发车时间

string

指的是从上车站点到下车站点这个方向上的末班车发车时间



使用方法
坐标系说明
WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标
国际化路线规划服务 v1.0的输入参数支持以上三种坐标系,开发者无需进行任何坐标转换,通过请求参数"coord_type"指明所使用的坐标系即可。输出参数支持国测局坐标(gcj02)和 百度坐标(bd09ll)两种坐标,通过请求参数"ret_coordtype"进行设置。
服务开通方法

国际化路线规划服务为付费服务,需单独申请开通国际化服务。

1、通过控制台获取ak

2、提交工单申请国际化服务权限

images%2FMacHi%202018-04-13%2019-38-19.png

服务配额

国际化路线规划服务为付费服务,根据需求日配额及并发次数付费使用,具体价格和配额提升请通过合作咨询联系我们了解。

每个开发者账号每天调用“国际化路线规划”API 服务的总次数(即配额)是有限的。

每个开发者账号每天调用“国际化路线规划”API 服务的总次数(即并发量)是有限的。

同一个账号下的HTTP/HTTPS请求,配额,并发共享。

编码说明
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控制台,我的服务中申请做进一步提升。

2018年3月24日

V1.0

产品上线

开放国际化路线规划服务,支持的出行方式有驾车、步行和公交。