全部服务产品
开发者频道
定价
登录
货车路线规划
下载开发文档
接口说明

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

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请求

请求参数
参数名称必填字段类型含义备注
originstring起点坐标格式为:纬度,经度。如:21.22345,112.11478
origin_bind_strategyint32起点绑路策略0:绑定封闭道路,1:不绑定封闭道路;默认0
destinationstring终点坐标格式与起点坐标相同
dest_bind_strategyint32终点绑路策略0:绑定封闭道路,1:不绑定封闭道路;默认0
waypointsstring途经点坐标

格式:支持18个以内的有序途径点。多个途径点坐标按顺序以英文竖线符号分隔,
示例: 40.465,116.314|40.232,116.352|40.121,116.453

coord_typestring输入坐标类型

坐标类型,可选参数,默认为bd09ll
允许的值为:
bd09ll(百度经纬度坐标)
bd09mc(百度墨卡托坐标)
gcj02(国测局加密坐标)
wgs84(gps设备获取的坐标)

ret_coordtypestring输出坐标类型

返回结果坐标类型,默认为bd09ll
允许的值为:
bd09ll(百度经纬度坐标)
gcj02(国测局加密坐标)

heightdouble车辆高度单位:米,取值[0, 10.0],默认1.8,会按照填写数字进行限行规避
widthdouble车辆宽度单位:米,取值[0, 3.0],默认1.9,会按照填写数字进行限行规避
weightdouble车辆总重车辆总重=车辆自身重量+货物重量,单位:吨,取值[0,100],默认2.5,会按照填写数字进行限行规避
lengthdouble车辆长度单位:米,取值[0,20.0],默认4.2,会按照填写数字进行限行规避
axle_weightdouble轴重单位:吨,取值[0,50],默认2,会按照填写数字进行限行规避
axle_countint32轴数取值[0,50],默认2,会按照填写数字进行限行规避
is_trailerint32是否是挂车

0:不是(默认)
1:是

plate_provincestring车牌号省份默认:空字串
plate_numberstring车牌号(省份以外号码)默认:空字串
plate_colorint32车牌颜色

0:蓝色(默认)
1:黄
2:黑
3:白
4:绿

departure_timeint32出发时间Unix时间戳(秒),默认为当前时间,支持未来7天内的区间:(now_timestamp - 600, now_timestamp + 7 * 86400)
eta_timestampint32ETA时间戳

0:实时ETA
1:静态ETA(历史均值)
未来时间戳:返回未来(历史) ETA (now_timestamp - 600, now_timestamp + 7 * 86400) 其他时间返回参数错误
注:根据departure_time算路,只是返回的duration按次字段规定填充

tacticsint32驾驶策略

0:默认 (时间优先)
1:距离优先
3:少走高速
4:高速优先
5:躲避拥堵
6:少收费
7:经济路线
8:距离优先+少走高速
9:躲避拥堵+少走高速
10:少收费+少走高速
11:躲避拥堵+少收费
12:躲避拥堵+少收费+少走高速
13:躲避拥堵+高速优先

way_tacticsint32途经点算路时各分段算路偏好

0,1...
各偏好间以逗号分隔,枚举值参考tactics字段说明,且个数为 途经点个数+1
如有1个途经点,则需传递2个偏好对应 起点→途经点; 途经点→终点 分段的偏好

alternativesint32是否返回备选路线

0:返回一条推荐路线 (默认)
1:返回1到3条备选路线

displacementint32百公里油耗,单位mL
vehicle_usagesstring货车用途

如果设置该字段,会根据货车用途进行限行规避
如:0,17
0-默认;17-危险物品
危化物品功能为高级付费服务,需通过反馈平台联系工作人员开通

power_typeint32动力类型

默认汽油
0-所有;1-汽油;2-柴油;3-电动;4-混合

truck_typeint32卡车类型1-微;2-轻;3-中;4-重;
emission_limitint32排放标准取值范围1-6,对应国1-国6标准
load_weightint32核定载重单位吨[0,1000]
avoid_typeint32货车政策交规(如交通部门发布的分时段区域限行政策)剥离

0:政策交规默认生效;
1:算路时忽略针对货车的政策交规(道路上实体交通标牌限制仍正常生效)

experience_trackstring用户指定经验轨迹

lat,lng,timestamp;lat,lng,timestamp;lat,lng,timestamp .....
轨迹点间英文分号分割
如无时间戳可设置为0,所有轨迹点个数小于2000。坐标类型受参数coord_type约定
如果传递此参数,则必须采用post方式发送Http请求,header中content-type设置为application/x-www-form-urlencoded,并且所有参数放置在body中进行发送
注意:该功能为高级付费功能,需通过反馈平台联系工作人员开通

navigableint64是否启用导航

设置该参数,可以支持将货车路线规划API算路结果传入货车导航SDK中并调起导航
1: 启用
0: 关闭
默认值为0

disable_ferryint32是否禁用轮渡

0: 不对轮渡做限制,可以走轮渡。默认
1: 禁用轮渡交通方式,不再考虑轮渡路线

akstring用户的AK,授权使用
snstring

用户的权限签名,若用户所用AK的校验方式为SN校验时该参数必须。参考:
sn校验说明

返回参数
字段名称字段类型字段含义
statusint32取值范围:
0:成功
1:服务内部错误
2:参数错误
更多状态码详见附录
messagestring状态码对应的信息
resultkv返回的结果
restrictionkv车牌限行信息(城市级别)
若一条路线触发多个限行,仅返回其中一个
typestring可能取值如下:
0:无限行;1:本地车限行;2:外地车限行,3:本地车尾号限行;4:外地车尾号限行;5:其他限行
infostring限行信息的文字
totalint32返回方案的总数
routesinfo_extstring路线扩展信息,如session_id,算路时间等,json结构字符串,原样透传
route_idstring该字段仅用于排查问题,无实际含义
routesarray返回的方案集
origin
lngdouble起点经度
latdouble起点纬度
destination
lngdouble终点经度
latdouble终点纬度
traffic_light_numint红绿灯个数
tagstring方案标签
track_idxint32轨迹索引,和输入的多段经验轨迹对应,说明此路线是参考哪个经验轨迹点计算的
-1: 不参考经验轨迹点计算的路线
大于等于0: 和经验轨迹点对应,索引从0开始
unavoid_polygons_idxstring未规避的避让区域索引,从0开始,如都已规避,则返回空字符串
distancedouble方案距离,单位:米
durationint32线路耗时,单位:秒(历史eta)
tollint32此路线道路收费,单位:元
注意:该字段为高级付费服务,需通过反馈平台联系工作人员开通
toll_distancedouble收费路段里程,单位:米
注意:该字段为高级付费服务,需通过反馈平台联系工作人员开通
oil_costdouble油费,单位元
stepsarray路线分段
leg_indexint32途径点序号,为从0开始的整数,用于标识step所属的途径点路段 如:若该step属于起点至第一个途径中的路段,则其leg_index为0
directionint32进入道路的角度。
枚举值,返回值在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°] 注:角度为与正北方向顺时针夹角
distancedoublestep的距离信息,单位:米
adcodesstring经过的城市列表,市级,英文逗号分隔
adcodes_namestring经过的城市列表,市级,英文逗号分隔(中文)
road_namestring分段的道路名称
road_typeint32分段的道路类型 枚举值:返回0-9之间的值
0:高速路
1:城市高速路
2:国道
3:省道
4:县道
5:乡镇村道
6:其他道路
7:九级路
8:航线(轮渡)
9:行人道路
toll_gate_namestring收费站名称
注意:该字段为高级付费服务,需通过反馈平台联系工作人员开通
toll_gate_location
lngdouble收费站位置:经度
注意:该字段为高级付费服务,需通过反馈平台联系工作人员开通
latdouble收费站位置:纬度
注意:该字段为高级付费服务,需通过反馈平台联系工作人员开通
start_location
lngdouble分段起点经度
latdouble分段起点纬度
end_location
lngdouble分段终点经度
latdouble分段终点纬度
pathstring分段坐标
traffic_conditionarray分段路况详情(填历史路况)
statusint路况指数
0 无路况数据 1 畅通 2 缓行 3 拥堵 4 严重拥堵
geo_cntint从当前坐标点开始,path中路况相同的坐标点个数
注:绘制路况时,指标指向第一个path的第一个点,往后数n个点组成的路段路况是一样的,计数时不算指标所在的点(当前step所有geo_cnt的和为path中的点数减1
distancedouble路况指数
0 无路况数据 1 畅通 2 缓行 3 拥堵 4 严重拥堵距离,从当前坐标点开始path 中路况相同的距离,单位:米
waypoints_tollarray途径点费用,根据leg_index对应,leg_index值为途径点费用数组索引值
如您需要获取经验路线,货车ETC费用,危化品路线规划及导航,请点击经验路线货车ETC费用危化品路线规划及导航
示例代码
填写您的AK

输入AK可生成包含IP/SN校验方式的代码

<?php
// 此处填写你在控制台-应用管理-创建应用后获取的AK
$ak = '您的AK';
// 发起一个http get请求,并返回请求的结果
// $url字段为请求的地址
// $param字段为请求的参数
function request_get($url = '', $param = array()) {
if (empty($url) || empty($param)) {
return false;
}
$getUrl = $url . "?" . http_build_query($param);
$curl = curl_init(); // 初始化curl
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); // 跳过证书检查
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 2); // 从证书中检查SSL加密算法是否存在
curl_setopt($curl, CURLOPT_URL, $getUrl); // 抓取指定网页
curl_setopt($curl, CURLOPT_TIMEOUT, 1000); // 设置超时时间1秒
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); // curl不直接输出到屏幕
curl_setopt($curl, CURLOPT_HEADER, 0); // 设置header
$data = curl_exec($curl); // 运行curl
if (!$data) {
print("an error occured in function request_get(): " . curl_error($curl) . "\n");
}
curl_close($curl);
return $data;
}
// 请求地址
$url = 'https://api.map.baidu.com/logistics_direction/v1/truck';
// 构造请求参数
$param['origin'] = '22.673186,114.065699';
$param['destination'] = '22.6721,114.068886';
$param['height'] = '1.8';
$param['width'] = '1.9';
$param['weight'] = '2.5';
$param['length'] = '4.2';
$param['axle_weight'] = '2';
$param['axle_count'] = '2';
$param['is_trailer'] = '0';
$param['plate_province'] = '';
$param['plate_number'] = '';
$param['plate_color'] = '0';
$param['ak'] = $ak;
$res = request_get($url, $param);
// 将原始返回的结果打印出来
print("请求的原始返回结果为:\n");
print($res . "\n");
?>
{
"status": 0,
"message": "ok",
"result": {
"restriction": {
"type": "0",
"info": ""
},
"total": 1,
"routes": [
{
"origin": {
"lng": 114.06571601088974,
"lat": 22.67317578337568
},
"destination": {
"lng": 114.06883474382559,
"lat": 22.672117710702736
},
"tag": "默认",
"distance": 880,
"duration": 450,
"steps": [
{
"leg_index": 0,
"direction": 7,
"distance": 268,
"road_name": "清祥路",
"road_type": 4,
"start_location": {
"lng": 114.06571601088974,
"lat": 22.67317578337568
},
"end_location": {
"lng": 114.06498411443144,
"lat": 22.67095626741058
},
"path": "114.065716,22.6731758;114.065506,22.6726359;114.065435,22.6724659;114.065385,22.672326;114.065235,22.6718961;114.065225,22.6718661;114.065175,22.6717461;114.065034,22.6713463;114.064934,22.6711064;114.064894,22.6709864;114.064984,22.6709563",
"traffic_condition": [
{
"status": 1,
"geo_cnt": 8,
"distance": 245
},
{
"status": 2,
"geo_cnt": 2,
"distance": 23
}
],
"restrictions": [
{}
],
"duration": 279,
"adcodes": "440309,440307"
},
{
"leg_index": 0,
"direction": 4,
"distance": 187,
"road_name": "环城路",
"road_type": 3,
"start_location": {
"lng": 114.06498411443144,
"lat": 22.67095626741058
},
"end_location": {
"lng": 114.06647375599361,
"lat": 22.67014499432073
},
"path": "114.064984,22.6709563;114.065264,22.6708159;114.065964,22.6704152;114.066284,22.670165;114.066414,22.670075;114.066474,22.670145",
"traffic_condition": [
{
"status": 2,
"geo_cnt": 5,
"distance": 187
}
],
"restrictions": [
{}
],
"duration": 104,
"adcodes": "440307"
},
{
"leg_index": 0,
"direction": 1,
"distance": 268,
"road_name": "五和大道",
"road_type": 3,
"start_location": {
"lng": 114.06647375599361,
"lat": 22.67014499432073
},
"end_location": {
"lng": 114.06812492008547,
"lat": 22.672016417426942
},
"path": "114.066474,22.670145;114.066664,22.670365;114.067394,22.6712055;114.068095,22.6719964;114.068125,22.6720164",
"traffic_condition": [
{
"status": 1,
"geo_cnt": 4,
"distance": 268
}
],
"restrictions": [
{}
],
"duration": 36,
"adcodes": "440307"
},
{
"leg_index": 0,
"direction": 4,
"distance": 112,
"road_name": "",
"road_type": 6,
"start_location": {
"lng": 114.06812492008547,
"lat": 22.672016417426942
},
"end_location": {
"lng": 114.06910443577772,
"lat": 22.671878283021133
},
"path": "114.068125,22.6720164;114.068215,22.6719865;114.068974,22.671758;114.069104,22.6718783",
"traffic_condition": [
{
"status": 0,
"geo_cnt": 3,
"distance": 112
}
],
"restrictions": [
{}
],
"duration": 16,
"adcodes": "440307"
},
{
"leg_index": 0,
"direction": 11,
"distance": 45,
"road_name": "",
"road_type": 6,
"start_location": {
"lng": 114.06910443577772,
"lat": 22.671878283021133
},
"end_location": {
"lng": 114.06883474382559,
"lat": 22.672117710702736
},
"path": "114.069104,22.6718783;114.068875,22.6720178;114.068815,22.6720877;114.068835,22.6721177",
"traffic_condition": [
{
"status": 0,
"geo_cnt": 3,
"distance": 45
}
],
"restrictions": [
{}
],
"duration": 6,
"adcodes": "440307"
}
],
"oil_cost": 0.46,
"track_idx": -1,
"unavoid_polygons_idx": "",
"traffic_light_num": 2
}
],
"routesinfo_ext": "eyJzZXNzaW9uX2lkIjoiIiwibG9jIjoibmoiLCJ0cmFja3B0c19kaXN0YW5jZXMiOls4ODBdfQ"
}
}
在线运行
参数备注必选
origin
22.673186,114.065699
destination
22.6721,114.068886
height
1.8
width
1.9
weight
2.5
length
4.2

上一篇

使用准备

下一篇

经验路线

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