货车路线规划 | 百度地图API SDK

所有文档

货车路线规划服务

服务概览

快速开始

使用准备

接口文档

服务功能

货车路线规划

进阶能力

经验路线危化品路线规划及导航货车路线规划高级字段

相关资料

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

货车路线规划

下载开发文档

接口说明

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

1. 支持全国同城/跨城路线规划

2. 支持规避物理限制：高、宽、重、轴重

3. 支持根据车牌号规避交规限行，支持区分蓝/黄/白/绿/黑车牌

4. 支持途径点，最多不超过18个

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

6. 支持12种路线策略选择，包括经济路线、时间优先、不走高速及躲避拥堵+少收费+不走高速、躲避拥堵+不走高速、躲避拥堵+少收费等组合策略

7. 支持传入经验路线

8. 支持当前及未来出行8个高级字段返回，包括道路电子眼信息、道路设施信息、交通事件信息等（详见接口文档及附表）

注意：
• 货车路线规划请求算路结果会和请求时间相关，请求时间不同可能触发不同时段的相关限行政策信息。若用于未来时间的调度场景，请注意请求服务时间段与运输时间段尽量相同。
• 如果传入了车牌号和车牌颜色，在考虑政策限行的同时会考虑本地化交规。

API服务地址

https://api.map.baidu.com/logistics_direction/v1/truck?origin=22.673186,114.065699&destination=22.6721,114.068886&height=1.8&width=1.9&weight=2.5&length=4.2&axle_weight=2&axle_count=2&is_trailer=0&plate_province=&plate_number=&plate_color=0&ak=你的AK
//GET请求

请求参数

参数名称	必填	字段类型	含义	备注
origin	是	string	起点坐标	格式为：纬度,经度。如：21.22345,112.11478
origin_bind_strategy	否	int32	起点绑路策略	0:绑定封闭道路，1:不绑定封闭道路；默认0
destination	是	string	终点坐标	格式与起点坐标相同
dest_bind_strategy	否	int32	终点绑路策略	0:绑定封闭道路，1:不绑定封闭道路；默认0
waypoints	否	string	途经点坐标	格式：支持18个以内的有序途径点。多个途径点坐标按顺序以英文竖线符号分隔，示例： 40.465,116.314\|40.232,116.352\|40.121,116.453
coord_type	否	string	输入坐标类型	坐标类型，可选参数，默认为bd09ll 允许的值为： bd09ll（百度经纬度坐标） bd09mc（百度墨卡托坐标） gcj02（国测局加密坐标） wgs84（gps设备获取的坐标）
ret_coordtype	否	string	输出坐标类型	返回结果坐标类型，默认为bd09ll 允许的值为： bd09ll（百度经纬度坐标） gcj02（国测局加密坐标）
height	否	double	车辆高度	单位：米，取值[0, 10.0]，默认1.8，会按照填写数字进行限行规避
width	否	double	车辆宽度	单位：米，取值[0, 10.0]，默认1.9，会按照填写数字进行限行规避
weight	否	double	车辆总重	车辆总重=车辆自身重量+货物重量，单位：吨，取值[0,100]，默认2.5，会按照填写数字进行限行规避
length	否	double	车辆长度	单位：米，取值[0, 25.0]，默认4.2，会按照填写数字进行限行规避
axle_weight	否	double	轴重	单位：吨，取值[0,50]，默认2，会按照填写数字进行限行规避
axle_count	否	int32	轴数	取值[0,50]，默认2，会按照填写数字进行限行规避
is_trailer	否	int32	是否是挂车	0：不是(默认) 1：是
plate_province	否	string	车牌号省份	默认：空字串
plate_number	否	string	车牌号（省份以外号码）	默认：空字串
plate_color	否	int32	车牌颜色	0：蓝色（默认） 1：黄 2：黑 3：白 4：绿
departure_time	否	int32	出发时间	Unix时间戳(秒)，默认为当前时间，支持未来7天内的区间：（now_timestamp - 600, now_timestamp + 7 * 86400）
eta_timestamp	否	int32	ETA时间戳	0：实时ETA 1：静态ETA（历史均值）未来时间戳：返回未来(历史) ETA （now_timestamp - 600, now_timestamp + 7 * 86400）其他时间返回参数错误注：根据departure_time算路，只是返回的duration按次字段规定填充
tactics	否	int32	驾驶策略	0：默认（时间优先） 1：距离优先 3：少走高速 4：高速优先 5：躲避拥堵 6：少收费 7：经济路线 8：距离优先+少走高速 9：躲避拥堵+少走高速 10：少收费+少走高速 11：躲避拥堵+少收费 12：躲避拥堵+少收费+少走高速 13：躲避拥堵+高速优先
way_tactics	否	int32	途经点算路时各分段算路偏好	0,1... 各偏好间以逗号分隔，枚举值参考tactics字段说明，且个数为途经点个数+1 如有1个途经点，则需传递2个偏好对应起点→途经点；途经点→终点分段的偏好
alternatives	否	int32	是否返回备选路线	0：返回一条推荐路线（默认） 1：返回1到3条备选路线
displacement	否	int32	百公里油耗，单位mL
vehicle_usages	否	string	货车用途	如果设置该字段，会根据货车用途进行限行规避如：0,17 0-默认；17-危险物品危化物品功能为高级付费服务，需通过反馈平台联系工作人员开通
power_type	否	int32	动力类型	默认汽油 0-所有；1-汽油；2-柴油；3-电动；4-混合
truck_type	否	int32	卡车类型	1-微；2-轻；3-中；4-重；
emission_limit	否	int32	排放标准	取值范围1-6，对应国1-国6标准
load_weight	否	int32	核定载重	单位吨[0,1000]
avoid_type	否	int32	货车政策交规（如交通部门发布的分时段区域限行政策）剥离	0：政策交规默认生效； 1：算路时忽略针对货车的政策交规（道路上实体交通标牌限制仍正常生效）
experience_track	否	string	用户指定经验轨迹	lat,lng,timestamp;lat,lng,timestamp;lat,lng,timestamp ..... 轨迹点间英文分号分割如无时间戳可设置为0，所有轨迹点个数小于2000。坐标类型受参数coord_type约定如果传递此参数，则必须采用post方式发送Http请求，header中content-type设置为application/x-www-form-urlencoded，并且所有参数放置在body中进行发送注意：该功能为高级付费功能，需通过反馈平台联系工作人员开通
navigable	否	int64	是否启用导航	设置该参数，可以支持将货车路线规划API算路结果传入货车导航SDK中并调起导航 1: 启用 0: 关闭默认值为0
disable_ferry	否	int32	是否禁用轮渡	0: 不对轮渡做限制，可以走轮渡。默认 1: 禁用轮渡交通方式，不再考虑轮渡路线
ak	是	string	用户的AK，授权使用
sn	否	string	用户的权限签名，若用户所用AK的校验方式为SN校验时该参数必须。参考： sn校验说明

返回参数

字段名称					字段类型	字段含义
status					int32	取值范围： 0：成功 1：服务内部错误 2：参数错误更多状态码详见附录
message					string	状态码对应的信息
result					kv	返回的结果
	restriction				kv	车牌限行信息（城市级别）若一条路线触发多个限行，仅返回其中一个
		type			string	可能取值如下： 0：无限行；1：本地车限行；2：外地车限行，3：本地车尾号限行；4：外地车尾号限行；5：其他限行
		info			string	限行信息的文字
	total				int32	返回方案的总数
	routesinfo_ext				string	路线扩展信息，如session_id，算路时间等，json结构字符串，原样透传
	route_id				string	该字段仅用于排查问题，无实际含义
	routes				array	返回的方案集
		origin
			lng		double	起点经度
			lat		double	起点纬度
		destination
			lng		double	终点经度
			lat		double	终点纬度
		traffic_light_num			int	红绿灯个数
		tag			string	方案标签
		track_idx			int32	轨迹索引，和输入的多段经验轨迹对应，说明此路线是参考哪个经验轨迹点计算的 -1: 不参考经验轨迹点计算的路线大于等于0: 和经验轨迹点对应，索引从0开始
		unavoid_polygons_idx			string	未规避的避让区域索引，从0开始，如都已规避，则返回空字符串
		distance			double	方案距离，单位：米
		duration			int32	线路耗时，单位：秒（历史eta）
		toll			int32	此路线道路收费，单位：元注意：该字段为高级付费服务，需通过反馈平台联系工作人员开通
		toll_distance			double	收费路段里程，单位：米注意：该字段为高级付费服务，需通过反馈平台联系工作人员开通
		oil_cost			double	油费，单位元
		steps			array	路线分段
			leg_index		int32	途径点序号，为从0开始的整数，用于标识step所属的途径点路段如：若该step属于起点至第一个途径中的路段，则其leg_index为0
			direction		int32	进入道路的角度。枚举值，返回值在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		double	step的距离信息，单位：米
			adcodes		string	经过的城市列表，市级，英文逗号分隔
			adcodes_name		string	经过的城市列表，市级，英文逗号分隔(中文)
			road_name		string	分段的道路名称
			road_type		int32	分段的道路类型枚举值：返回0-9之间的值 0：高速路 1：城市高速路 2：国道 3：省道 4：县道 5：乡镇村道 6：其他道路 7：九级路 8：航线(轮渡) 9：行人道路
			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	分段坐标
			traffic_condition		array	分段路况详情（填历史路况）
				status	int	路况指数 0 无路况数据 1 畅通 2 缓行 3 拥堵 4 严重拥堵
				geo_cnt	int	从当前坐标点开始，path中路况相同的坐标点个数注：绘制路况时，指标指向第一个path的第一个点，往后数n个点组成的路段路况是一样的，计数时不算指标所在的点（当前step所有geo_cnt的和为path中的点数减1
				distance	double	路况指数 0 无路况数据 1 畅通 2 缓行 3 拥堵 4 严重拥堵距离，从当前坐标点开始path 中路况相同的距离，单位：米
		waypoints_toll			array	途径点费用，根据leg_index对应，leg_index值为途径点费用数组索引值

如您需要获取经验路线，货车ETC费用，危化品路线规划及导航，请点击经验路线，货车ETC费用，危化品路线规划及导航。

使用准备

经验路线

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