服务文档

接口功能文档

货车路线规划

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

货车规划请求参数

参数名称	是否必填	字段类型	含义	备注
origin	是	string	起点坐标	格式为：纬度,经度。如：21.22345,112.11478
destination	是	string	终点坐标	格式与起点坐标相同
waypoints	否	string	途经点坐标	格式：支持20个以内的有序途径点。多个途径点坐标按顺序以英文竖线符号分隔， 示例： 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,5.0]，默认1.8，会按照填写数字进行限行规避
width	否	double	车辆宽度	单位：米，取值[0,3.0]，默认1.9，会按照填写数字进行限行规避
weight	否	double	车辆总重	车辆总重=车辆自身重量+货物重量，单位：吨，取值[0,100]，默认2.5，会按照填写数字进行限行规避
length	否	double	车辆长度	单位：米，取值[0,20.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：实时ETA1：静态ETA（历史均值）未来时间戳：返回未来(历史) ETA （now_timestamp - 600, now_timestamp + 7 * 86400） 其他时间返回参数错误注：根据departure_time算路，只是返回的duration按次字段规定填充
tactics	否	int32	驾驶策略	0：默认 （时间优先） 1：距离优先 3：少走高速 7：经济路线
way_tactics	否	string	途经点算路时各分段算路偏好	0,1... 各偏好间以逗号分隔，枚举值参考tactics字段说明，且个数为 途经点个数+1 如有1个途经点，则需传递2个偏好对应 起点→途经点； 途经点→终点 分段的偏好
alternatives	否	int32	是否返回备选路线	0：返回一条推荐路线 （默认） 1：返回1到3条备选路线
user_mark	否	string	用户标识	规避自定义区域时的特殊字段 格式：大小写字母、数字、英文逗号、英文分号
displacement	否	int32	百公里油耗，单位mL
vehicle_usages	否	string	货车用途	如果设置该字段，会根据货车用途进行限行规避如：0,170-默认；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]
multi	否	int32	性能模式	0：开启性能模式。在性能模式下，服务耗时会明显缩减，但路线不会考虑当天上线的新交规数据
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结构字符串，原样透传
routes	array	返回的方案集
	origin	lng	double	起点经度
lat	double	起点纬度
destination	lng	double	终点经度
lat	double	终点纬度
traffic_light_num	int	红绿灯个数
unavoid_statistics		本条线路未规避信息汇总注意：未规避信息为高级付费服务，需通过反馈平台联系工作人员开通
	height				int	限高个数
	width				int	限宽个数
	weight				int	限重个数
	plate				int	货车标牌个数
	road_to_open				int	即将开通道路数
	road_not_open				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的距离信息，单位：米
duration	int32	线路耗时，单位：秒若选择实时ETA，则返回考虑实时路况的ETA若选择静态ETA，则返回一个历史估值ETA
adcodes	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	距离，从当前坐标点开始path 中路况相同的距离，单位：米