产品服务
解决方案
文档与支持
定价
登录
驾车路线规划
下载开发文档
接口说明

根据起终点坐标检索符合条件的驾车路线规划方案,支持以下功能:

1. 支持一次请求返回多条路线(备用路线)

2. 支持18个以内的途径点

3. 支持传入车牌规避限行路段

4. 支持传入起点车头方向,辅助判断起点所在正逆向车道,辅助更准确算路

5. 支持未来出行规划,指定未来7天任意出发时刻,将依据智能预测路况和道路限行规划合理路线

API服务地址

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.30815string必填起点经纬度,格式为:纬度,经度;小数点后不超过6位,40.056878,116.30815
destination终点经纬度,小数点后不超过6位,40.056878,116.30815string必填终点经纬度,格式为:纬度,经度;小数点后不超过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选填默认bd09II
tactics

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

int选填默认0:默认策略
alternatives

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

int选填默认0
cartype

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

int选填默认0
plate_number

车牌号,如 京A00022
用于规避车牌号限行路段。
1、若有规避限行区域的可选路线,则返回规避后的路线,不会返回限行路线
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选填

不填则不返回ext_duration字段
注意:该功能为高级付费服务,需通过工单联系工作人员开通

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

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

radius起点的定位精度,字段类型:float,取值范围[0,2000]float选填配合gps_direction字段使用
speed起点车辆的行驶速度,字段类型:floatfloat选填

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

output表示输出类型,可设置为xml或jsonstring选填默认为json
sn

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

string选填
timestamp时间戳,与SN配合使用int64SN存在时必填
callback回调函数string选填仅在output=json时,该参数有效
intelligent_plan

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

int选填

默认0:不执行途经点智能规划
注意:该功能为高级付费服务,需通过工单联系工作人员开通

walkinfo起终点步导路线int选填

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

steps_info

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

int选填
origin_bind_stategy

起点绑路策略
0-起点绑路不剔除封闭道路
1-起点绑路剔除封闭道路

int选填默认值0
dest_bind_stategy

终点绑路策略
0-终点绑路不剔除封闭道路
1-终点绑路剔除封闭道路

int选填默认值0
origin_road_type

起点道路类型,
0 普通道路[默认。绑路策略不参考此入参];
1高架上;2高架下;3主路;4辅路;(高速和匝道切换其实相当于主辅路切换)

int选填默认值0
返回参数
字段名称字段含义字段类型备注
status状态码int0:成功
1:服务内部错误
2:参数无效
7:无返回结果
message状态码对应的信息string
type默认返回2,开发者无需关注int
result返回的结果
restriction限行结果提示信息
若无限行路线,则返回空
若无法规避限行,则返回限行提示信息
string
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
traffic_light红绿灯数量int
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
stepsarray路线分段
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°]
注:角度为与正北方向顺时针夹角
distancestep的距离信息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路况指数int0: 无路况 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
如您需要获取未来驾车路线规划,驾车路线历史耗时,建议出发时间,途经点智能路线规划,请点击未来驾车路线规划驾车路线历史耗时建议出发时间途经点智能路线规划

上一篇

使用准备

下一篇

骑行路线规划

本篇文章对您是否有帮助?