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

WEB 服务API

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

服务介绍
服务文档
使用指南
常见问题
更新日志
轻量级路线规划服务 V1.0

轻量级路线规划服务(又名DirectionLite API )是一套REST风格的Web服务API,以HTTP/HTTPS形式提供了路线规划服务。相较于Direction API ,DirectionLite API更注重服务的高性能和接口的轻便简洁。DirectionLite API支持驾车、骑行、步行、公交路线规划,支持中国大陆地区。

功能介绍
驾车路线规划
根据起终点坐标规划驾车出行路线和耗时,支持:
1. 支持5个途经点
2. 支持设置偏好:常规路线、不走高速、躲避拥堵
3. 支持传入起点车头方向,辅助判断起点所在正逆向车道,辅助更准确算路

骑行路线规划

根据起终点坐标规划骑行出行路线和耗时,支持普通自行车和电动自行车出行方式



步行路线规划

根据起终点坐标规划步行出行路线和耗时



公交路线规划
根据起终点坐标规划同城公共交通出行路线和耗时,支持公交、地铁出行方式
接口功能文档
驾车路线规划
http://api.map.baidu.com/directionlite/v1/driving?origin=40.01116,116.339303&destination=39.936404,116.452562&ak=您的AK
驾车规划请求参数

字段名称

字段含义

字段类型

是否必填

备注

ak 开发者密钥,AK申请
string

origin

起点

"double,double"

起点经纬度,格式为:纬度,经度;小数点后不超过6位,40.056878,116.30815

destination

 

终点

"double,double"

终点经纬度,格式为:纬度,经度;小数点后不超过6位,40.056878,116.30815

waypoints
途经点 string

支持5个以内的有序途径点。多个途径点坐标按顺序以英文竖线符号分隔,示例: 40.465,116.314|40.232,116.352|40.121,116.453
tactics
路线偏好 int 默认值:0。
可选值:
0:常规路线,即多数用户常走的一条经验路线,满足大多数场景需求,是较推荐的一个策略
1:不走高速
2:躲避拥堵
gps_direction
起点的定位方向 int64 车头方向为与正北方向夹角,取值范围[0,359]。
该参数用于辅助判断起点所在正逆向车道,提高算路准确率。 当speed>1.5m/s且gps_direction存在时,采用该方向。gps_direction并不代表需填写从gps获取的方向,可以填入校正后的方向。请填写尽量准确的方向,其准确性很大程度决定了计算的精度。
radius
起点的定位精度 float 配合gps_direction字段使用
speed
起点车辆的行驶速度
float 配合gps_direction字段使用。
当speed>1.5m/s且gps_direction存在时,采用gps_direction的方向

coord_type

 

输入坐标类型

string

默认bd09ll
允许的值为:
bd09ll:百度经纬度坐标
bd09mc:百度墨卡托坐标
gcj02:国测局加密坐标
wgs84:gps设备获取的坐标

ret_coordtype

输出坐标类型

string

返回值的坐标类型,默认为百度经纬度坐标:bd09ll

可选值:

bd09ll:百度经纬度坐标

gcj02:国测局加密坐标

sn

用户的权限签名,当AK设置为SN校验时,该参数必填
SN计算方法

string


timestamp

时间戳,与SN配合使用

string

SN存在时必填

 

驾车规划返回参数

字段名称

字段含义

备注

status

状态码

0:成功
1:服务内部错误
2:参数无效
7:无返回结果

message

状态码对应的信息

 

result

返回的结果

 

origin
lng 起点经度

lat 起点纬度

destination
lng 终点经度

lat 终点纬度

routes

返回的方案集

 

 

distance

方案距离,单位:米

 

duration

线路耗时,单位:秒

 

traffic_condition 路线的整体路况评价
取值范围
0: 无路况
1: 畅通
2: 缓行
3: 拥堵
4: 严重拥堵 

steps

路线分段

 

 

leg_index

途径点序号

途径点序号为从0开始的整数,用于标识step所属的途径点路段
如:若该step属于起点至第一个途径中的路段,则其leg_index为0

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°]

turn 机动转向点,包括基准八个方向、环岛、分歧等
枚举值,返回0-16之间的一个值,共17个枚举值。分别代表的含义是:
0:无效
1:直行
2:右前方转弯
3:右转
4:右后方转弯
5:掉头
6:左后方转弯
7:左转
8:左前方转弯
9:左侧
10:右侧
11:分歧-左
12:分歧中央
13:分歧右
14:环岛
15:进渡口
16:出渡口

distance

路段距离

单位:米

duration
路段耗时
单位:秒
instruction
路段描述

start_location

lng

分段起点经度

 

lat

分段起点纬度

 

end_location

lng

分段终点经度

 

lat

分段终点纬度

 

path

分段坐标

 

traffic_condition

分段路况详情

 

 

status

路况指数

取值范围
0: 无路况
1: 畅通
2: 缓行
3: 拥堵
4: 严重拥堵 

geo_cnt

从当前坐标点开始,path中路况相同的坐标点个数

 


骑行路线规划
http://api.map.baidu.com/directionlite/v1/riding?origin=40.01116,116.339303&destination=39.936404,116.452562&ak=您的AK
骑行规划请求参数

字段名称

字段含义

字段类型

是否必填

备注

ak 开发者密钥,AK申请
string

origin

起点

"double,double"

起点经纬度,格式为:纬度,经度;小数点后不超过6位,40.056878,116.30815

destination

 

终点

"double,double"

终点经纬度,格式为:纬度,经度;小数点后不超过6位,40.056878,116.30815

riding_type
骑行类型
string

默认0
0:普通自行车
1:电动自行车

coord_type

 

输入坐标类型

string

默认bd09ll
允许的值为:
bd09ll:百度经纬度坐标
bd09mc:百度墨卡托坐标
gcj02:国测局加密坐标
wgs84:gps设备获取的坐标

ret_coordtype

输出坐标类型

string

返回值的坐标类型,默认为百度经纬度坐标:bd09ll

可选值:

bd09ll:百度经纬度坐标

gcj02:国测局加密坐标

sn

用户的权限签名,当AK设置为SN校验时,该参数必填
SN计算方法

string


timestamp

时间戳,与SN配合使用

string

SN存在时必填

 


骑行规划返回参数

 字段名称

字段含义

备注

status

状态码

0:成功
1:服务内部错误
2:参数无效
7:无返回结果

message

状态码对应的信息

 

type

返回数据类型

 

result

返回的结果

 

origin
lng 起点经度

lat 起点纬度

destination
lng 终点经度

lat 终点纬度

routes

返回的方案集

 

 

distance

方案距离,单位:米

 

duration

线路耗时,单位:秒

 

steps

路线分段

 

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°]

turn_type 行驶转向方向 如“直行”、“左前方转弯”

distance

路段距离

单位:米

duration
路段耗时
单位:秒
name 道路名称 如:“信息路”
若道路未明明或百度地图未采集到该道路名称,则返回“无名路“
instruction
路段描述

start_location

lng

分段起点经度

lat

分段起点纬度

end_location

lng

分段终点经度

lat

分段终点纬度

path

分段坐标

步行路线规划
http://api.map.baidu.com/directionlite/v1/walking?origin=40.01116,116.339303&destination=39.936404,116.452562&ak=您的AK
步行规划请求参数

字段名称

字段含义

字段类型

是否必填

备注

ak 开发者密钥,AK申请
string

origin

起点

"double,double"

起点经纬度,格式为:纬度,经度;小数点后不超过6位,40.056878,116.30815

destination

 

终点

"double,double"

终点经纬度,格式为:纬度,经度;小数点后不超过6位,40.056878,116.30815

coord_type

 

输入坐标类型

string

默认bd09ll
允许的值为:
bd09ll:百度经纬度坐标
bd09mc:百度墨卡托坐标
gcj02:国测局加密坐标
wgs84:gps设备获取的坐标

ret_coordtype

输出坐标类型

string

返回值的坐标类型,默认为百度经纬度坐标:bd09ll

可选值:

bd09ll:百度经纬度坐标

gcj02:国测局加密坐标

sn

用户的权限签名,当AK设置为SN校验时,该参数必填
SN计算方法

string


timestamp

时间戳,与SN配合使用

string

SN存在时必填

 


步行规划返回参数

 字段名称

字段含义

备注

status

状态码

0:成功
1:服务内部错误
2:参数无效
7:无返回结果

message

状态码对应的信息

 

type

返回数据类型

 

result

返回的结果

 

origin
lng 起点经度

lat 起点纬度

destination
lng 终点经度

lat 终点纬度

routes

返回的方案集

 

 

distance

方案距离,单位:米

 

duration

线路耗时,单位:秒

 

steps

路线分段

 

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

路段距离

单位:米

duration
路段耗时
单位:秒
instruction
路段描述

start_location

lng

分段起点经度

lat

分段起点纬度

end_location

lng

分段终点经度

lat

分段终点纬度

path

分段坐标


公交路线规划
http://api.map.baidu.com/directionlite/v1/transit?origin=40.056878,116.30815&destination=31.222965,121.505821&ak=您的AK
公交规划请求参数

字段名称

字段含义

字段类型

是否必填

备注

ak 开发者密钥,AK申请
string

origin

起点

"double,double"

起点经纬度,格式为:纬度,经度;小数点后不超过6位,40.056878,116.30815

destination

 

终点

"double,double"

终点经纬度,格式为:纬度,经度;小数点后不超过6位,40.056878,116.30815

coord_type

 

输入坐标类型

string

默认bd09ll
允许的值为:
bd09ll:百度经纬度坐标
bd09mc:百度墨卡托坐标
gcj02:国测局加密坐标
wgs84:gps设备获取的坐标

ret_coordtype

输出坐标类型

string

返回值的坐标类型,默认为百度经纬度坐标:bd09ll

可选值:

bd09ll:百度经纬度坐标

gcj02:国测局加密坐标

sn

用户的权限签名,当AK设置为SN校验时,该参数必填
SN计算方法

string


timestamp

时间戳,与SN配合使用

string

SN存在时必填

 


公交规划返回参数
字段名称 字段含义 备注
status 状态码 0:成功
1:服务器内部错误
2:参数无效
1001:没有公交方案
1002:没有匹配的POI
message 状态码对应的信息
result 返回的结果 如果status为1001 或1002,此字段为null
origin lng 起点经度
lat 起点纬度
destination lng 终点经度
lat 起点纬度
taxi detail 出租车的详细信息
desc 白天还是夜间
km_price 每公里价格(元)
start_price 起步价(元)
total_price 总价(元)
distance 出租车预计里程数
duration 出租车预计耗时
remark 出租车备注信息
routes 路线方案
distance 本条路线的总距离(米)
duration 本条路线的总耗时(秒)
traffic_condition 路况信息
取值范围:
0:无路况
1:畅通
2:缓行
3:拥堵
price 本条路线的总票价(元) 非大陆地区此字段值为null
line_price 车票详细信息 起终点为大陆地区同城时此字段为一个数组,数组中的每一项都有ticket_type 和ticket_price 两个字段;
起终点为大陆跨城时,该字段为一个空的数组。
line_type 票类型 0:公交票价
1: 地铁票价
line_price 价格 单位:元
steps
路线分段
数组,数组中的每一项是一步(step)。每条路线都由多个step组成
distance
距离(米)
duration
耗时(秒)
instructions
描述
type
路段出行方式
1:火车
2:飞机
3:公交
4:驾车
5:步行
6:大巴
path
路线坐标
坐标系由ret_coordtype设置,示例:“116.321858,40.039183;116.3216343,40.039141”
start_location lng
本step 起点经度
坐标系由ret_coordtype设置
lat
本step 起点纬度
坐标系由ret_coordtype设置
end_location lng
本step 终点经度
坐标系由ret_coordtype设置
lat
本step 终点纬度
坐标系由ret_coordtype设置
vehicle name
公交路线名称
direction_text
路线方向说明

start_name
公交线路起点名称

end_name
公交线路终点名称

start_time
公交线路首班车时间

end_time
公交线路的末班车时间

stop_num
路段经过的站点数量

total_price
价格

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


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

服务相关配额及并发请求限制请访问开发者权益页面查看。

编码说明
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服务一样,具有每天使用配额和并发次数的限制。如果您的使用配额或并发不能满足业务使用需求,可以通过认证个人/企业开发者的方式,提升配额。如果您已经是企业认证开发者,配额/并发依然不够使用,可在配额提升页面中获取更高配额。

2018年11月14日

V1.0

产品上线

支持驾车、骑行(普通自行车、电动自行车)、步行、同城公交路线规划