浏览器版本低！无法浏览完整内容，建议升级或更换浏览器。
服务介绍
服务文档
使用指南
常见问题
更新日志
内容（服务介绍）
路线规划服务

路线规划服务（又名Direction API）是一套REST风格的Web服务API，以HTTP/HTTPS形式提供了路线规划服务。目前，Direction API支持公交、骑行、驾车路线规划，Direction API支持中国大陆地区。

功能介绍
摩托车路线规划

根据起终点坐标检索符合条件的摩托车规划方案，支持以下功能：
1、支持传入丰富车辆信息（车牌、车牌颜色、排量等）
2、支持全国100+城市限行规避
3、支持设置多个途经点，支持途经点ETA计算
4、支持实时路况算路
5、支持设置个性化车标
6、支持多种路线偏好选择，如高速优先、躲避拥堵、少收费等


公交路线规划

根据起点和终点检索符合条件的公共交通方案，融入出行策略（少换乘、地铁优先等）
支持大陆区域的同城及跨城路线规划，交通方式支持公交、地铁、火车、飞机、大巴


骑行路线规划

根据起终点坐标检索符合条件的骑行路线规划方案，支持普通自行车和电动自行车出行方式


驾车路线规划
根据起终点坐标检索符合条件的驾车路线规划方案，支持以下功能：
1. 支持一次请求返回多条路线（备用路线）
2. 支持18个以内的途径点
3. 支持传入车牌规避限行路段
4. 支持传入起点车头方向，辅助判断起点所在正逆向车道，辅助更准确算路
5. 支持未来出行规划，指定未来7天任意出发时刻，将依据智能预测路况和道路限行规划合理路线
内容（服务文档）
接口功能文档
摩托车路线规划为开放平台高级服务，需申请开通权限后才能访问服务
https://api.map.baidu.com/direction/v2/motorcycle?origin=4846797.3,12948640.7&destination=4836829.84,12967554.88&coord_type=bd09mc&ak=您的AK //GET请求
摩托车路线规划请求参数

字段名称

字段含义

类型

是否必填

备注

ak

用户的访问权限，AK申请

string

必填


origin

支持以下对起点的描述: 1. 起点经纬度，小数点后不超过6位， 40.056878,116.30815(若使用POI 的 导航坐标即XXXX，将会提升路线规 划的准确性) 2. 名称(该参数仅对sdk和js api开放)

string

必填

起点和终点的直线距离不得超过400km


destination

支持以下对终点的描述：

终点经纬度，小数点后不超过6位，40.056878,116.30815（若使用POI 的导航坐标即XXXX，将会提升路线规划的准确性） 名称（该参数仅对sdk和js api开放）

string

选填

起点和终点的直线距离不得超过400km



origin_uid


POI 的 uid(在已知起点POI 的 uid 情况下， 请尽量填写uid，将提升路线规划的准确性。使用地点检索服务获取uid ， 使用地点输入提示服务获取uid )

string

选填


destination_uid

 

POI 的 uid(在已知终点POI 的 uid 情况下， 请尽量填写uid，将提升路线规划的准确性。使用地点检索服务获取uid ， 使用地点输入提示服务获取uid )

string

选填



waypoints

途径点坐标串，支持18个以内的有序途径点。 多个途径点坐标按顺序以英文竖线符号分隔， 示例: 40.465,116.314|40.232,116.352|40. 121,116.453

string

选填


coord_type

坐标类型，可选参数，默认为bd09ll。允许的 值为:
bd09ll(百度经纬度坐标)、
bd09mc (百度墨卡托坐标)、
gcj02(国测局加密坐 标)、
wgs84(gps设备获取的坐标)

string

选填

默认bd09II

ret_coordtype

返回结果坐标类型，默认为bd09ll，允许的值 为:bd09ll(百度经纬度坐标)、gcj02(国测 局加密坐标)

string

选填

默认bd09ll

tactics

0：默认
3：不走高速
4：高速优先
5：躲避拥堵
6：少收费
7：躲避拥堵&高速优先
8：躲避拥堵&不走高速
9：躲避拥堵&少收费
10：躲避拥堵&不走高速&少收费
11：不走高速&少收费

int

选填

默认0:默认策略

alternatives

是否返回备选路线 类型:string
可选值:
0:返回一条推荐路线
1:返回1-3条路线供选择

int

选填

默认:0


plate_number

车牌号，如 京A00022 用于规避车牌号限行路段。
1. 若有规避限行区域的可选路线， 则返回规避后的路线，不会返回限行 路线
2.若无规避限行的可选路线(如: 起终点在限行区域内，或所有符合偏 好的路线都无法规避限行区域)，则返回限行路线中最优路线，并在返回字段 restriction 中提示用户路段被限行

string

选填

不填则不作规避

displacement

摩托车排量，单位cc

int

选填

取值范围 [0,10000]


gps_direction

起点的车头方向。 字段类型:int64 取值范 围:0-359

int

选填

车头方向为与正北方向顺时针夹角，该参数用于辅助判断起点所在正逆向车道，提高算路准 确率。 当speed>1.5米/秒且gps_direction存在 时，采用该方向。gps_direction并不代表需填 写从gps获取的方向，可以填入校正后的方 向。请填写尽量准确的方向，其准确性很大程 度决定了计算的精度。

radius

起点的定位精度，字段类型:float，取值范围 [0,2000]

float

选填

配合gps_direction字段使用

speed

起点车辆的行驶速度，字段类型:float

float

选填

 单位:米/秒，配合gps_direction字段使用，当 speed>1.5米/秒且gps_direction存在时，采用 gps_direction的方向

output

表示输出类型，可设置为xml或json

string

选填

默认为json

sn

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

string

选填


timestamp

时间戳，与SN配合使用

int64

SN存在时必填

SN存在时必填

callback

回调函数

string

选填

仅再output=json时，该参数有效


摩托车规划返回参数

字段名称

字段含义

类型

备注

status

状态码

int

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

message

状态码对应的信息

string


result

返回的结果


 


restriction

限行结果提示信息

string

1: 若无限行路 线，则返回空 2: 若无法规避限 行，则返回限行 提示信息

total

返回方案的总数

int


routes

返回的方案集

array

若请求参数设置 了符合规则的 departure_time， 则按照设定时间 的预测路况和限 行规则计算路 线。 若未设置 departure_time， 则按照当前时刻 的路况和限行规 则计算路线

origin

lng

起点经度

double

 

lat

起点纬度

double

 

destination

lng

终点经度

double

 

lat

终点纬度

double

 

tag

方案标签

string

 

restriction_info


status

限行状态

int

取值范围【0,3】 0:无限行 1:已规避限行， 路线合法 2:无法规避限 行，路线非法 3：疫情相关的信息

desc

限行提示语

string

当限行status为1或 2时，会有相应的 限行描述信息。 若该路线有多条 提示信息，则以 英文竖线分隔符 分隔，如: "已为您避开北京 限行区域" "无法为您避开北 京限行区域，请 合理安排出行" "起点在北京限行 区域，请合理安 排出行" "终点在北京限行 区域，请合理安 排出行" "起点在北京限行 区域，请合理安 排出行|终点在北 京限行区域，请 合理安排出行"

distance

方案距离，单 位:米

int


duration

线路耗时，单 位:秒

int


taxi_fee

出租车费用，单 位:元

int

toll

此路线道路收费，单位:元

int

此高速费为预估价格，与实际高速收费并不完全一致

toll_distance

收费路段里程， 单位:米

int

steps

路线分段

array

leg_index

途径点序号

int

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

direction

进入道路的角度

int

枚举值，返回值 在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的距离信息

int

单位米


road_name

分段的道路名称

string

如“信息路“ 若道路未命名或 百度地图未采集 到该道路名称， 则返回"无名路"


road_type

分段的道路类型

int

枚举值:返回0-9 之间的值 0:高速路 1:城市高速路 2: 国道 3:省道 4:县道 5:乡镇村道 6:其他道路 7:九级路 8:航线(轮渡) 9:行人道路

toll

分段道路收费， 单位:元

int

因一个收费路段 可能覆盖多个 step，部分情况下 费用无法按step准 确拆分，故分段 step收费可能存在 不准确情况

toll_distance

分段道路收费路 程，单位:米

int

toll_gate_name

收费站名称

string

只有在进收费站 和出收费站时才 有

toll_gate_location

lng

收费站位置:经 度

double

只有在进收费站和出收费站时才有

lat

收费站位置:纬 度

double

只有在进收费站和出收费站时才有

start_location

lng

分段起点经度

double

 

lat

分段起点纬度

double

 

end_location

lng

分段终点经度

double

 

lat

分段终点纬度

double

 

path

分段坐标

string

adcodes

分段途经的城市 编码

string

若途经多个城 市，则adcode以英 文半角逗号相隔 如: 110000,120000

traffic_condition

分段路况详情

array


status

路况指数

int

0: 无路况 1: 畅通 2: 缓行 3: 拥堵 4: 非常拥堵

geo_cnt

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

int

distance

距离，从当前坐 标点开始path 中 路况相同的距 离，单位:米

float

注:单条线路中 所有distance的和 会与route的 distance字段存在 差异，不是完全 一致


公交路线规划
https://api.map.baidu.com/direction/v2/transit?origin=40.056878,116.30815&destination=31.222965,121.505821&ak=您的AK  //GET请求
公交规划请求参数
字段名称 字段含义 字段类型 是否必填 备注
origin 起点 "double,double"，格式为：纬度,经度，小数点后不超过6位，如：“40.056878,116.30815”
 必填
destination 终点 "double,double"，格式为：纬度,经度，小数点后不超过6位，如：“40.056878,116.30815”
 必填
origin_uid POI 的 uid（在已知起点POI 的 uid 情况下，请尽量填写uid，将提升路线规划的准确性，使用地点检索服务获取uid ， 使用地点输入提示服务获取uid ) string
 选填
destination_uid POI 的 uid（在已知终点POI 的 uid 情况下，请尽量填写uid，将提升路线规划的准确性，使用地点检索服务获取uid ， 使用地点输入提示服务获取uid ) string
 选填
coord_type 起终点的坐标类型 string 选填 默认为bd09ll
可选值：
bd09ll（百度经纬度坐标）
gcj02（国测局加密坐标）
wgs84（gps 设备获取的坐标）
departure_date 出发日期 string
 选填 可指定出发日期，若不填默认规则如下：

1. 若为起终点为同城：则默认为当天
2. 若为起终点为跨城：则默认第二天

departure_time 出发时间区间 string
 选填 出发时间区间，格式为：

1. hh:mm-hh:mm，如”08:00-14:00”：表示只查询发车时间在8点至14点之间的方案
2. hh:mm，如”08:00” ：表示只查询发车时间在8点至24点的方案

tactics_incity 市内公交换乘策略 int(0-5) 选填 默认为0
可选值：
0 推荐
1 少换乘
2 少步行
3 不坐地铁
4 时间短
5 地铁优先
tactics_intercity 跨城公交换乘策略 int(0-2) 选填 默认为0
可选值：
0 时间短
1 出发早
2 价格低
trans_type_intercity 跨城交通方式策略 int(0-2) 选填 默认为0
可选值：
0 火车优先
1 飞机优先
2 大巴优先
ret_coordtype 返回值的坐标类型 string 选填 默认为百度经纬度坐标：bd09ll

可选值：

bd09ll：百度经纬度坐标

gcj02：国测局坐标

output 输出类型 string 选填 默认为json
可选值:
json
xml
page_size 返回每页几条路线 int(1-10) 选填 默认为10
page_index 返回第几页 int 选填 默认为1
ak 开发者密钥，AK申请 string 必填
sn 用户的权限签名，当AK设置为SN校验时，该参数必填
SN计算方法 		string 必填
timestamp 时间戳，与SN配合使用 string SN存在时必填 SN存在时必填。
callback 回调函数，用于解决浏览器请求跨域问题 string 选填 仅在 output=json时该参数有效。
公交规划返回参数
字段名称 字段含义 字段类型 备注
status 状态码 int 0：成功
1：服务器内部错误
2：参数无效
1001：没有公交方案
1002：不支持跨域
message 状态码对应的信息 string
result 返回的结果 dict 如果status为1001 或1002，此字段为null
origin city_id 起点城市ID string
city_name 起点城市名称 string
location lng 起点坐标的经度值 double 坐标系由ret_coordtype设置
lat 终点坐标的纬度值 double
destination city_id 终点城市ID string
city_name 终点城市名称 string
location lng 终点坐标的经度值 double 坐标系由ret_coordtype设置
lat 终点坐标的纬度值 double
taxi detail 出租车的详细信息 array 仅在同城请求时才返回
desc 白天还是夜间 string
km_price 每公里价格（元） double
start_price 起步价（元） double
total_price 总价（元） double
distance 出租车预计里程数 int
duration 出租车预计耗时 int
remark 出租车备注信息 string
total 所有路线的总数 int
 符合条件的所有routes 的总数
routes 每页page_size 条，第page_index页的路线 array 请求中指定的page_index 和page_size 的部分。数组元素个数为page_size，每个元素代表从起点到终点的一条路线。
distance 本条路线的总距离（米） int
duration 本条路线的总耗时（秒） int
arrive_time 本条路线预计到达时间 string 格式为2016-04-05 17:06:10
price 本条路线的总票价（元） double 境外地区此字段值为null
price_detail 车票详细信息 array 起终点为境内同城时此字段为一个数组，数组中的每一项都有ticket_type 和ticket_price 两个字段；
起终点为境内跨城时，该字段为一个空的数组。
ticket_type 票类型 int(0-1) 0 公交票价；1 地铁票价
ticket_price 价格（元） double 本类型的票的总价
steps 本条路线有几个step（步骤） array 数组，数组中的每一项是一步（step）。每条路线都由多个step组成。
起终点为同城时，比如从奎科大厦到西直门分3个step，第一步是奎科大厦步行到上地五街，第二步是上地五街到上地地铁站，第三步是上地地铁站到西直门；
起终点为跨城时，比如从奎科大厦到天津大学分3个step，第一步是奎科大厦到北京南站，第二步是北京南站到天津站，第三步是天津站到天津大学。
schemes 本step 中的有几个scheme（方案）或sub_step（子步骤） array 当起终点为同城时，一个step 中可能会有多个scheme（方案），上述同城的第二步上地五街到上地地铁站可以坐205或447，每一种是一个scheme；
当起终点为跨城时，一个step 中可能会有多个sub_step（子步骤），上述跨城的第一步从奎科大厦到北京南站分为多个sub_step(子步骤)，这里的每个子步骤类似同城时的一个scheme（方案）。
distance 本step 的距离（米） int
duration 本step 的耗时（秒） int
instructions 本step 的描述 string
path 本step 中的关键点坐标 string 坐标系由ret_coordtype设置，示例：“116.321858,40.039183;116.3216343,40.039141”
traffic_condition 本step 中的路况信息 array 目前无输出
start_location lng 本step 起点经度 double 坐标系由ret_coordtype设置
lat 本step 起点纬度 double
end_location lng 本step 终点经度 double 坐标系由ret_coordtype设置
lat 本step 终点纬度 double
vehicle_info type 本step 中交通方式的类型 int 1：火车
2：飞机
3：公交
4：驾车
5：步行
6：大巴
detail 交通方式的具体信息 火车、飞机、大巴、公交4 种交通方式的这个字段有各自的格式，参见下面的文档，步行和驾车为null。


火车：vehicle_info 中type=1（火车）时detail 字段格式
字段名称 字段含义 字段类型 备注
name 火车车次名称 string
price 总票价 double
booking 订票电话 string
departure_station 上车火车站名称 string
arrive_station 下车火车站名称 string
departure_time 发车时间 string 所乘的火车在上车火车站的发车时间
arrive_time 到站时间 string 所乘的火车在下车火车站的到站时间
start_info start_name string 起点站名
start_city string 起点所在城市名称
start_time string 出发时间
end_info end_name string 终点站名
end_city string 终点所在城市名称
end_time string 抵达时间


飞机：vehicle_info 中type=2（飞机）时detail 字段格式
字段名称 字段含义 字段类型 备注
name 航班名称 string
price 总票价 double
discount 折扣 double
airlines 航空公司 string
booking 订票网址 string
departure_station 登机机场名称 string
arrive_station 下飞机机场名称 string
departure_time 飞机起飞时间 string
arrive_time 飞机降落时间 string
start_info start_name string 起点站名
start_city string 起点所在城市名称
start_time string 出发时间
end_info end_name string 终点站名
end_city string 终点所在城市名称
end_time string 抵达时间


公交：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 指的是从上车站点到下车站点这个方向上的末班车发车时间
start_info start_time string 首班车时间
start_ uid string 起点poi 的 uid
start_name string 起点公交站名称
end_info end_ time string 末班车时间
end_ uid string 终点POI 的 uid
end_name string 终点公交站名称


大巴：vehicle_info 中type=6（大巴）时detail 字段格式
字段名称 字段含义 字段类型 备注
name 大巴班次名称 string
price 总票价 double
booking 订票网址 string
provider_name 合作方名称 string
provider_url 合作方官网地址 string
departure_station 上车汽车站名称 string
arrive_station 下车汽车站名称 string
departure_time 发车时间 string
arrive_time 到站时间 string
start_info start_name string 起点站名
start_city string 起点所在城市名称
start_time string 出发时间
end_info end_name string 终点站名
end_city string 终点所在城市名称
end_time string 抵达时间


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

字段名称

字段含义

字段类型

是否必填

备注

origin

起点

"double,double"

是

起点经纬度，格式为：纬度,经度；小数点后不超过6位，40.056878,116.30815

destination

 

终点

"double,double"

是

终点经纬度，格式为：纬度,经度；小数点后不超过6位，40.056878,116.30815



origin_uid

 

起点POI的uid(请尽量填写uid，将提升路线规划的准确性。使用地点检索服务获取uid ， 使用地点输入提示服务获取uid )

string

否


destination_uid

 

终点POI的uid(请尽量填写uid，将提升路线规划的准确性。使用地点检索服务获取uid ， 使用地点输入提示服务获取uid )

string

否


coord_type

 

输入坐标类型

string

否

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

ret_coordtype

输出坐标类型

string

否

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

可选值：

bd09ll：百度经纬度坐标

gcj02：国测局坐标

output

表示输出类型，可设置为xml或json

 string

否

默认为json

riding_type

骑行类型

string

否

默认0：0-普通  1-电动车

ak

用户的访问权限，AK申请

string

是


sn

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

string

否


timestamp

时间戳，与SN配合使用

string

SN存在时必填

 

callback

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

string

否

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


骑行规划返回参数

字段名称

字段含义

备注

status

状态码

0：成功
1：服务内部错误
2：参数无效
2001：无骑行路线

message

状态码对应的信息

例如 message："ok"

type

返回数据类型


info

版权信息

 

result

返回的结果

 

routes

distance

方案距离

单位：米

duration

线路耗时

单位：秒

steps

direction

当前道路方向角

 

distance

路段距离

单位：米

duration

路段耗时

单位：秒

instructions

路段描述

如“骑行50米“

name

该路段道路名称

如“信息路“
若道路未命名或百度地图未采集到该道路名称，则返回"无名路"

path

路段位置坐标描述

 

turn_type

行驶转向方向

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

stepOrigin location

lng

路段起点经度

 

lat

路段起点纬度

 

stepDestination location

lng

路段终点经度

 

lat

路段终点纬度

 

restrictions_status

限行类型

0x01表示禁行；0x02表示逆行

restrictions_info

限行信息

如 "包含禁行路段|包含逆行路段"

links

link信息


length

link长度

单位：米

attr

link属性

0x01表示禁行；0x02表示逆行

originLocation

lng

路线起点经度

 

lat

路线起点纬度

 

destinationLocation

lng

路线终点经度

 

lat

路线终点纬度

 

restrictions_status

限行类型

0x01表示禁行；0x02表示逆行

restrictions_info

限行信息

如 "包含禁行路段|包含逆行路段"

origin

originPt

lng

起点经度

 

lat

起点纬度

destination

destinationPt

lng

终点经度

 

lat 终点纬度


驾车路线规划
https://api.map.baidu.com/direction/v2/driving?origin=40.01116,116.339303&destination=39.936404,116.452562&ak=您的AK  //GET请求
驾车规划请求参数

字段名称

字段含义

类型

是否必填

备注

ak

用户的访问权限，AK申请

string

必填


origin   

起点经纬度，小数点后不超过6位，40.056878,116.30815

string

必填

起点经纬度，格式为：纬度,经度；小数点后不超过6位，40.056878,116.30815

destination

终点经纬度，小数点后不超过6位，40.056878,116.30815

string

必填

终点经纬度，格式为：纬度,经度；小数点后不超过6位，40.056878,116.30815

origin_uid

POI 的 uid（在已知起点POI 的 uid 情况下，请尽量填写uid，将提升路线规划的准确性，使用地点检索服务获取uid ， 使用地点输入提示服务获取uid )

string

选填


destination_uid

POI 的 uid（在已知终点POI 的 uid 情况下，请尽量填写uid，将提升路线规划的准确性，使用地点检索服务获取uid ， 使用地点输入提示服务获取uid )


string

选填


waypoints

途径点坐标串，支持18个以内的有序途径点。多个途径点坐标按顺序以英文竖线符号分隔，示例： 40.465,116.314|40.232,116.352|40.121,116.453

string

选填


coord_type

坐标类型，可选参数，默认为bd09ll。允许的值为：bd09ll（百度经纬度坐标）、bd09mc（百度墨卡托坐标）、gcj02（国测局加密坐标）、wgs84（gps设备获取的坐标）。

string

选填

默认bd09II

ret_coordtype

返回结果坐标类型，默认为bd09ll，允许的值为：bd09ll（百度经纬度坐标）、gcj02（国测局加密坐标）

string

选填

默认bd09ll

tactics

0：默认
2：距离最短（只返回一条路线，不考虑限行和路况，距离最短且稳定，用于估价场景）
3：不走高速
4：高速优先
5：躲避拥堵
6：少收费
7: 躲避拥堵 & 高速优先
8: 躲避拥堵 & 不走高速
9: 躲避拥堵 & 少收费
10: 躲避拥堵 & 不走高速 & 少收费
11: 不走高速 & 少收费
12: 距离优先（考虑限行和路况，距离相对短且不一定稳定）
13：时间优先

int

选填

默认0：默认策略

alternatives


是否返回备选路线
类型：string

可选值：

0：返回一条推荐路线
1：返回1-3条路线供选择

string

选填

默认：0

cartype 车辆类型，区分车辆是普通燃油车或纯电动汽车。由于部分城市对燃油车和电动车限行规则有差异，该字段用于结合plate_number车牌号来规避限行。例如：纯电动汽车在北京本地无尾号限行，而燃油车需遵守尾号限行。
可选值：
0：普通汽车
1：纯电动汽车

int

选填


默认：0

plate_number

车牌号，如 京A00022
用于规避车牌号限行路段。

  1. 1、若有规避限行区域的可选路线，则返回规避后的路线，不会返回限行路线
  2. 2、若无规避限行的可选路线（如：起终点在限行区域内，或所有符合偏好的路线都无法规避限行区域），则返回限行路线中最优路线，并在返回字段 restriction 中提示用户路段被限行

string

选填


不填则不作规避

departure_time

设置出发时间（支持未来7天），UNIX时间戳。
该字段将影响duration字段的返回，用于返回未来驾车路线耗时。取值范围：当前时间之后7天*24小时内任意时刻（超出时间范围将预估路线）
若设置该参数，则路线规划服务将依据设定时间预测路况和限行规则，并据此计算路线和耗时。

string

选填

默认为当前时间
注意：该功能为高级付费服务，需通过反馈平台联系工作人员开通
ext_departure_time

更多出发时间，UNIX时间戳。
该字段将影响ext_duration字段的返回，用于返回驾车路线历史耗时（路线在指定出发时间的耗时）。目前支持输入过去7天内一个或多个出发时间戳（不超过12个），多个时间戳之间用","英文半角逗号隔开。示例： ext_departure_time=1526527619�
ext_departure_time=1526527619,1526525384,1526523654��

注：目前出发时间仅影响ext_duration字段，还不会影响路线计算和选择。即仍按照现在的路况计算并推荐路线，但将增加返回该路线在其他时间的耗时。

string

选填

不填则不返回ext_duration字段
注意：该功能为高级付费服务，需通过反馈平台联系工作人员开通


expect_arrival_time

预期的到达时间，UNIX时间戳。

该字段将影响suggest_departure_time字段的返回，用于返回建议出发时间。取值范围：当前时间之后15分钟的任意时刻（小于这个时间则不做处理）

若设置此参数，则路线规划服务将依据设定时间计算路线和耗时，并给出建议出发时间

若算出的suggest_departure_time小于当前时间，则设置suggest_departure_time为-1

string

选填

不填则不返回suggest_departure_time字段
注意：该功能为高级付费服务，需通过反馈平台联系工作人员开通


gps_direction

起点的车头方向。 字段类型：int64 取值范围：0-359

int

选填

车头方向为与正北方向顺时针夹角，该参数用于辅助判断起点所在正逆向车道，提高算路准确率。 当speed>1.5米/秒且gps_direction存在时，采用该方向。gps_direction并不代表需填写从gps获取的方向，可以填入校正后的方向。请填写尽量准确的方向，其准确性很大程度决定了计算的精度。

radius

起点的定位精度，字段类型：float，取值范围[0,2000]

float

选填

配合gps_direction字段使用

speed

起点车辆的行驶速度，字段类型：float

float

选填

单位：米/秒，配合gps_direction字段使用，当speed>1.5米/秒且gps_direction存在时，采用gps_direction的方向。

output

表示输出类型，可设置为xml或json

string

选填

默认为json

sn

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

string

选填


timestamp

时间戳，与SN配合使用

int64

SN存在时必填


callback

回调函数

string

选填

仅在output=json时，该参数有效

intelligent_plan

传入多个途经点，综合考虑路况、交规限行、 途经点的相对位置以及路线整体的绕路成本等，支持智能调整途经点顺序，给出最优路线。
可选值：
0（默认值）：不执行途经点智能规划
1：执行途经点智能规划

int

选填

默认0：不执行途经点智能规划
注意：该功能为高级付费服务，需通过反馈平台联系工作人员开通

walkinfo

起终点步导路线

int

选填

1 表示下发起终点步导路线；
0 不下发起终点步导路线；
默认值为0

steps_info

是否下发step详情
1：下发step详情
0：不下发step详情

int

否


驾车规划返回参数

 字段名称


字段含义

类型

备注

status

状态码

int

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

message

状态码对应的信息

string

 

type

默认返回2，开发者无需关注

int

 


result

返回的结果

 

 

restriction

限行结果提示信息

  1. 若无限行路线，则返回空
  2. 若无法规避限行，则返回限行提示信息

string

 


duration

step的耗时

int

单位秒


total

返回方案的总数

int

 

routes

返回的方案集


若请求参数设置了符合规则的departure_time，则按照设定时间的预测路况和限行规则计算路线。
若未设置departure_time，则按照当前时刻的路况和限行规则计算路线 

 

restriction_info




 

status

限行状态

int

取值范围【0,3】 0:无限行 1:已规避限行， 路线合法 2:无法规避限 行，路线非法 3：疫情相关的信息  

desc

限行提示语

string

当限行status为1或 2时，会有相应的 限行描述信息。 若该路线有多条 提示信息，则以 英文竖线分隔符 分隔，如: "已为您避开北京 限行区域" "无法为您避开北 京限行区域，请 合理安排出行" "起点在北京限行 区域，请合理安 排出行" "终点在北京限行 区域，请合理安 排出行" "起点在北京限行 区域，请合理安 排出行|终点在北 京限行区域，请 合理安排出行"  

origin

lng

起点经度

double

 

lat

起点纬度

double

 

destination

lng

终点经度

double

 

lat

终点纬度

double

 

tag

方案标签

string

 

route_id

如无特殊需要，开发者无需关注

string

 

distance

方案距离，单位：米

int

 

duration

未来驾车路线耗时，单位：秒

int

若请求参数设置了符合规则的departure_time，则按照设定出发时间的预测路况计算路线耗时。
若未设置departure_time，则按照当前时刻的路况计算路线耗时  注意：该功能为高级付费服务，需通过反馈平台联系工作人员开通

ext_duration 驾车路线历史耗时（扩展），单位：秒

int

若设置了请求参数ext_departure_time，则返回该字段；
�若ext_departure_time设置了一个或多个出发时间则以英文半角逗号","分隔返回多个扩展耗时；
�若扩展耗时计算失败，则返回-1。
注意：该功能为高级付费服务，需通过反馈平台联系工作人员开通

suggest_departure_time 建议出发时间，单位：秒

int64

若请求参数设置了符合规则的expect_arrival_time，则按照预计到达时间预测路况计算路线，并给出建议出发时间。
�

若算出的suggest_departure_time小于当前时间，则设置suggest_departure_time为-1。注意：该功能为高级付费服务，需通过反馈平台联系工作人员开通


taxi_fee
 出租车费用，单位：元

int


toll

此路线道路收费，单位：元

int

 此高速费为预估价格，与实际高速收费并不完全一致

toll_distance

收费路段里程，单位：米

int

 

steps

array

路线分段

 

leg_index

途径点序号

int

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

direction

进入道路的角度

int

枚举值，返回值在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的距离信息

int

单位米

road_name

分段的道路名称

string

如“信息路“
若道路未命名或百度地图未采集到该道路名称，则返回"无名路" 

road_type

分段的道路类型

int

枚举值：返回0-9之间的值
0：高速路
1：城市高速路
2:国道
3：省道
4：县道
5：乡镇村道
6：其他道路
7：九级路
8：航线(轮渡)
9：行人道路

toll

分段道路收费，单位：元

int

因一个收费路段可能覆盖多个step，部分情况下费用无法按step准确拆分，故分段step收费可能存在不准确情况

toll_distance

分段道路收费路程，单位：米

int

 

toll_gate_name

收费站名称

string

只有在进收费站和出收费站时才有

toll_gate_location

lng

收费站位置：经度

double

只有在进收费站和出收费站时才有

lat

收费站位置：纬度

double

start_location

lng

分段起点经度

double

 

lat

分段起点纬度

double

 

end_location

lng

分段终点经度

double

 

lat

分段终点纬度

double

 

path

分段坐标

string

 


adcodes

分段途经的城市编码

string

若途经多个城市，则adcode以英文半角逗号相隔

 

traffic_condition

分段路况详情

array

 

 

status

路况指数

int

0： 无路况
1： 畅通
2： 缓行
3： 拥堵
4： 非常拥堵 

geo_cnt

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

int

 

distance

距离，从当前坐标点开始path 中路况相同的距离，单位：米

float

注：单条线路中所有distance的和会与route的distance字段存在差异，不是完全一致

end_walkinfo

终点步导路线

array

 

distance

终点步导路线距离

int

单位米

path

终点步导路线坐标点

string

start_walkinfo

起点步导路线

array

 

distance

起点步导路线距离

int

单位米

path

起点步导路线坐标点

string

traffic_light

红绿灯数量

int

内容（使用指南）
使用方法

1 注册百度账号

2 申请成为百度开发者

3 获取密钥（AK）

4 发送请求，使用服务

坐标系说明
WGS84：为一种大地坐标系，也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
GCJ02：是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
BD09：为百度坐标系，在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托米制坐标
路线规划服务API的输入参数支持以上三种坐标系，开发者无需进行任何坐标转换，通过请求参数"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服务一样，具有每天使用配额和并发次数的限制。如果您的使用配额或并发不能满足业务使用需求，可以通过认证个人/企业开发者的方式，提升配额。如果您已经是企业认证开发者，配额/并发依然不够使用，可在配额提升页面中获取更高配额。

内容（更新日志）

2016年9月5日

V2.0

2017年1月3日

V2.0

2017年4月6日

V2.0

2017年12月28日

V2.0

2018年6月11日

V2.1

2018年7月13日

V2.2

2019年1月25日

V2.2.1

2019年10月11日

V2.2.2

产品上线

开放公交换乘方案的线路数据，全面支持跨城公交。在公交和地铁的基础上，同时支持火车、飞机、城际大巴多种公共出行方式。

新增字段

vehicle_info中新增 start_info 和 end_info，返回该 step 起终点详细信息。

新增字段

请求参数新增 ret_coordtype 字段（支持百度和国测局坐标），用于控制返回值的坐标类型，如 path等。

新增功能

新增驾车路线规划，支持返回多路线，支持规避车牌限行路段

新增骑行路线规划，支持电动车骑行出行方式

新增功能

1. 驾车路线规划新增输入起点车头方向功能，该功能通过行驶的车头方向、车行速度、定位精度三个字段辅助判断起点所在道路的正逆向（例如：在道路的南向北方向），从而实现更准确的算路，支持网约车等行业实现更精准的司机到达时间和距离计算。 d 2. 驾车路线规划新增途径点功能，支持20个有序途径点。

新增功能

1. 驾车路线规划新增历史耗时功能，通过ext_departure_time输入历史7天内任意出发时刻，服务将根据对历史路况的挖掘，返回路线在指定时刻的耗时预估ext_duration。该功能可应用于预约出行耗时预估场景，如网约车、上门服务等行业预估预约订单的出行耗时。注：若需试用该功能，请通过反馈平台申请开通权限

新增功能

1. 驾车路线规划新增未来出行功能，通过departure_time未来7天内任意出发时刻，路线规划服务将依据设定时间预测路况和限行规则，并据此计算路线和耗时。该功能可应用于预约出行耗时预估场景，如网约车、上门服务等行业预估预约订单的出行耗时。注：若需试用该功能，请通过反馈平台申请开通权限

新增功能

1. 驾车路线规划新增针对纯电动汽车限行规避功能，新增请求字段cartype用于区分车辆类型（普通燃油车/纯电动汽车），该字段结合车牌号plate_number进行车牌号可对支持纯电动汽车限行规避。

取自“http://lbsyun.baidu.com/index.php?title=webapi/direction-api-v2&oldid=17816”

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误，或对此文档有更好的建议，请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消