货车路线规划 | 百度地图api sdk-凯发k8官方旗舰厅

浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
货车路线规划
下载开发文档
接口说明

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

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

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

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

4. 支持途径点,最多不超过20个

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

6.支持多种路线策略选择,包括经济路线、距离优先、时间优先、不走高速策略

7.支持传入经验路线

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
destinationstring终点坐标格式与起点坐标相同
waypointsstring途经点坐标

格式:支持20个以内的有序途径点。多个途径点坐标按顺序以英文竖线符号分隔,
示例: 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,5.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:少走高速
7:经济路线

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结构字符串,原样透传
routesarray返回的方案集
origin
lngdouble起点经度
latdouble起点纬度
destination
lngdouble终点经度
latdouble终点纬度
traffic_light_numint红绿灯个数
unavoid_statistics本条线路未规避信息汇总
注意:未规避信息为高级付费服务,需通过联系工作人员开通
heightint限高个数
widthint限宽个数
weightint限重个数
plateint货车标牌个数
road_to_openint即将开通道路数
road_not_openint阻断道路数
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经过的城市列表,市级,英文逗号分隔
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分段终点纬度
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 中路况相同的距离,单位:米
如您需要获取经验路线,货车etc费用,危化品路线规划及导航,请点击经验路线货车etc费用危化品路线规划及导航
示例代码
填写您的ak

输入ak可生成包含ip/sn校验方式的代码

<?php
// 此处填写你在控制台-应用管理-创建应用后获取的ak
$ak ='您的ak';
// 发起一个http get请求,并返回请求的结果
// $url字段为请求的地址
// $param字段为请求的参数
functionrequest_get($url ='', $param =array()){
if(empty($url)||empty($param)){
returnfalse;
}
$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

上一篇

使用准备

下一篇

经验路线

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

网站地图