浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
第2,017行: 第2,017行:
  
 
| width="142" valign="top" |  
 
| width="142" valign="top" |  
如 "包含禁行路段|包含逆行路段"
+
如 "包含禁行路段|包含逆行路段"
  
 
|-
 
|-
第2,113行: 第2,113行:
  
 
| width="142" valign="top" |  
 
| width="142" valign="top" |  
如 "包含禁行路段|包含逆行路段"
+
如 "包含禁行路段|包含逆行路段"
  
 
|-
 
|-
第2,315行: 第2,315行:
  
 
| width="400" valign="top" style="width: 503px;" |  
 
| width="400" valign="top" style="width: 503px;" |  
0:默认<br/>2:距离最短(只返回一条路线,不考虑限行和路况,距离最短且稳定,用于估价场景)<br/>3:不走高速<br/>4:高速优先<br/>5:躲避拥堵<br/>6:少收费<br/>7: 躲避拥堵 & 高速优先<br/>8: 躲避拥堵 & 不走高速<br/>9: 躲避拥堵 & 少收费<br/>10: 躲避拥堵 & 不走高速 & 少收费<br/>11: 不走高速 & 少收费<br/>12: 距离优先(考虑限行和路况,距离相对短且不一定稳定)
+
0:默认<br/>2:距离最短(只返回一条路线,不考虑限行和路况,距离最短且稳定,用于估价场景)<br/>3:不走高速<br/>4:高速优先<br/>5:躲避拥堵<br/>6:少收费<br/>7: 躲避拥堵 & 高速优先<br/>8: 躲避拥堵 & 不走高速<br/>9: 躲避拥堵 & 少收费<br/>10: 躲避拥堵 & 不走高速 & 少收费<br/>11: 不走高速 & 少收费<br/>12: 距离优先(考虑限行和路况,距离相对短且不一定稳定)<br/>13:时间优先
  
 
| width="198" valign="top" style="width: 326px;" |  
 
| width="198" valign="top" style="width: 326px;" |  
第2,550行: 第2,550行:
 
| width="220" valign="top" |  
 
| width="220" valign="top" |  
 
默认0:不执行途经点智能规划<br/><span style="color:#FF0000;">注意:该功能为高级付费服务,需通过</span>[https://lbs.baidu.com/apiconsole/fankui#?typeOne=30046&typeTwo=53524&typeThree=95961 <span style="color:#FF0000;">反馈平台</span>]<span style="color:#FF0000;">联系工作人员开通</span>
 
默认0:不执行途经点智能规划<br/><span style="color:#FF0000;">注意:该功能为高级付费服务,需通过</span>[https://lbs.baidu.com/apiconsole/fankui#?typeOne=30046&typeTwo=53524&typeThree=95961 <span style="color:#FF0000;">反馈平台</span>]<span style="color:#FF0000;">联系工作人员开通</span>
|-
 
  
 +
|-
 
| width="104" valign="top" |  
 
| width="104" valign="top" |  
 
walkinfo
 
walkinfo
第2,566行: 第2,566行:
 
| width="220" valign="top" |  
 
| width="220" valign="top" |  
 
1 表示下发起终点步导路线;<br/>0 不下发起终点步导路线;<br/>默认值为0
 
1 表示下发起终点步导路线;<br/>0 不下发起终点步导路线;<br/>默认值为0
 +
 
|}
 
|}
  
第3,151行: 第3,152行:
 
注:单条线路中所有distance的和会与route的distance字段存在差异,不是完全一致
 
注:单条线路中所有distance的和会与route的distance字段存在差异,不是完全一致
  
|-  
+
|-
 
+
 
| width="218" colspan="6" valign="top" |  
 
| width="218" colspan="6" valign="top" |  
 
end_walkinfo
 
end_walkinfo
第3,163行: 第3,163行:
  
 
| width="326" valign="top" |  
 
| width="326" valign="top" |  
 
 
|-
 
|-
 
 
| width="218" colspan="6" valign="top" |  
 
| width="218" colspan="6" valign="top" |  
 
distance
 
distance
第3,177行: 第3,175行:
 
| width="326" valign="top" |  
 
| width="326" valign="top" |  
 
单位米
 
单位米
|-
 
  
 +
|-
 
| width="218" colspan="6" valign="top" |  
 
| width="218" colspan="6" valign="top" |  
 
path
 
path
第3,189行: 第3,187行:
  
 
| width="326" valign="top" |  
 
| width="326" valign="top" |  
 
+
|-
|-  
+
 
+
 
| width="218" colspan="6" valign="top" |  
 
| width="218" colspan="6" valign="top" |  
 
start_walkinfo
 
start_walkinfo
第3,202行: 第3,198行:
  
 
| width="326" valign="top" |  
 
| width="326" valign="top" |  
 
 
|-
 
|-
 
 
| width="218" colspan="6" valign="top" |  
 
| width="218" colspan="6" valign="top" |  
 
distance
 
distance
第3,216行: 第3,210行:
 
| width="326" valign="top" |  
 
| width="326" valign="top" |  
 
单位米
 
单位米
|-
 
  
 +
|-
 
| width="218" colspan="6" valign="top" |  
 
| width="218" colspan="6" valign="top" |  
 
path
 
path
第3,228行: 第3,222行:
  
 
| width="326" valign="top" |  
 
| width="326" valign="top" |  
 
 
|}
 
|}
 
</div><div class="navRemark"><div class="handpointto">内容(使用指南)</div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">使用方法</div></div><div class="useguide"><div class="useguide_bg"></div><div class="useguide_li">
 
</div><div class="navRemark"><div class="handpointto">内容(使用指南)</div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">使用方法</div></div><div class="useguide"><div class="useguide_bg"></div><div class="useguide_li">

2022年8月5日 (五) 14:04的版本

服务介绍
服务文档
使用指南
常见问题
更新日志
路线规划服务

路线规划服务(又名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,2】 0:无限行 1:已规避限行, 路线合法 2:无法规避限 行,路线非法

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


驾车规划返回参数

 字段名称


字段含义

类型

备注

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,则按照当前时刻的路况和限行规则计算路线 

 

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

int

路线分段

 

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

使用方法
坐标系说明
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进行车牌号可对支持纯电动汽车限行规避。

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

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

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消