路线规划（v2） | 百度地图API SDK

所有文档

路线规划服务

服务概览

快速开始

使用准备

接口文档

服务功能

驾车路线规划骑行路线规划步行路线规划公交路线规划

进阶能力

摩托车路线规划未来驾车路线规划驾车路线历史耗时建议出发时间途经点智能路线规划

相关资料

更新日志常见问题资源下载使用指南

驾车路线规划

下载开发文档

接口说明

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

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.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	选填	默认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-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	选填
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					状态码	int	0：成功 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
		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字段存在差异，不是完全一致
	end_walkinfo				终点步导路线	array
		distance			终点步导路线距离	int	单位米
		path			终点步导路线坐标点	string
	start_walkinfo				起点步导路线	array
		distance			起点步导路线距离	int	单位米
		path			起点步导路线坐标点	string

如您需要获取未来驾车路线规划，驾车路线历史耗时，建议出发时间，途经点智能路线规划，请点击未来驾车路线规划，驾车路线历史耗时，建议出发时间，途经点智能路线规划。

使用准备

骑行路线规划

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