浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

所有文档

货车批量算路

货车批量算路
下载开发文档
接口说明

物流批量算路服务的配额和并发是按最终路线数来计算,而非Logistics RouteMatrix API请求数。如一次请求2个起点5个终点,则最终路线输出为2*5=10条,配额计为10次。

1. 支持全国同城/跨城批量算路,一次请求支持计算50条路线的实际行驶距离和耗时
2. 支持规避物理四限:高、宽、重、轴重
3. 支持根据车牌号规避交规限行,支持区分蓝/黄/白/绿/黑车牌
4. 支持依据实时路况计算路线距离和耗时
5. 支持未来7天预测道路限行
6. 支持多种路线策略选择,包括省钱路线、不走高速、高速优先等策略

API服务地址

https://api.map.baidu.com/logistics_routematrix/v1/truck?origins=39.952778,116.314582&destinations=36.705386,116.746957|36.47832,116.37854&height=1.8&width=1.9&weight=2.5&length=4.2&axle_weight=2&axle_count=2&is_trailer=0&ak=您的AK
//GET请求

请求参数
字段名称必填字段类型字段含义备注
originsstring起点坐标串

格式为:纬度,经度|纬度,经度。如:21.22345,112.11478|21.47832,112.37854
注:起终点个数乘积不超过50

destinationsstring终点坐标串

格式与起点坐标相同
注:起终点个数乘积不超过50

coord_typestring输入坐标类型

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

heightdouble车辆高度

单位:米,取值[0,5.0],默认1.8,会按照填写数字进行限行规避,字段类型double,单位:米

widthdouble车辆宽度

单位:米,取值[0,3.0],默认1.9,会按照填写数字进行限行规避,字段类型double,单位:米

weightdouble车辆总重

车辆总重=车辆自身重量+货物重量,单位:吨,取值[0,100],默认2.5,会按照填写数字进行限行规避,字段类型double,车辆总重=车辆自身重量+货物重量,单位:吨

lengthdouble车辆长度

单位:米,取值[0,20.0],默认4.2,会按照填写数字进行限行规避,字段类型double,单位:米

axle_weightdouble轴重

单位:吨,取值[0,50],默认2,会按照填写数字进行限行规避,字段类型double,单位:吨

axle_countint32轴数

取值[0,50],默认2,会按照填写数字进行限行规避字段类型int64

is_trailerint32是否是挂车

0:不是(默认)
1:是

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

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

departure_timeint32出发时间

Unix时间戳(秒),默认为当前时间,一期支持未来3天内的区间:(now_timestamp - 600, now_timestamp + 3 * 86400)

tacticsint32驾驶策略

0:默认 (时间优先)
1:距离优先
3:不走高速
6:少收费

avoid_typeint32货车政策交规(如交通部门发布的分时段区域限行政策)剥离

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

user_markstring用户标识

规避自定义区域时的特殊字段
格式:大小写字母、数字、英文逗号、英文分号

akstring用户的AK,授权使用
snstring

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

返回参数
字段名称字段含义字段类型备注
status状态码int320:成功
1:服务内部错误
2:参数错误
更多状态码详见附录
message返回信息string对status的中文描述
result返回的结果array数组中的每个元素代表一个起点和一个终点的检索结果。顺序依次为(以2起点2终点为例):
origin1-destination1,
origin1-destination2,
origin2-destination1,
origin2-destination2
restriction车牌限行 kv
type限制类型 string可能取值如下:
0:无限行;1:本地车限行;2:外地车限行;3:本地车尾号限行;4:外地车尾号限行;5:其他限行
info限制详情string限行信息的文字
distance路线距离 kv
text线路距离的文本描述string文本描述的单位有米、公里两种
value线路距离的数值double单位为米
如果值为0:算路请求正常,但两点间无路线
如果值为-1:算路请求异常,可以重试一次
duration路线耗时kv
text路线耗时的文本描述string文本描述的单位有分钟,小时两种
value路线耗时的数值double单位为秒
如果值为0:算路请求正常,但两点间无路线
如果值为-1:算路请求异常,可以重试一次
示例代码
填写您的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_routematrix/v1/truck';
// 构造请求参数
$param['origins'] = '39.952778,116.314582';
$param['destinations'] = '36.705386,116.746957|36.47832,116.37854';
$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['ak'] = $ak;
$res = request_get($url, $param);
// 将原始返回的结果打印出来
print("请求的原始返回结果为:\n");
print($res . "\n");
?>
{
"status": 0,
"message": "ok",
"result": [
{
"restriction": {
"type": "0",
"info": ""
},
"distance": {
"value": 408172,
"text": "408.2公里"
},
"duration": {
"value": 17237,
"text": "4小时47分钟"
}
},
{
"restriction": {
"type": "0",
"info": ""
},
"distance": {
"value": 469515,
"text": "469.5公里"
},
"duration": {
"value": 20251,
"text": "5小时37分钟"
}
}
]
}
在线运行
参数备注必选
origins
39.952778,116.314582
destinations
36.705386,116.746957|36.47832,116.37854
height
1.8
width
1.9
weight
2.5
length
4.2
axle_weight
2
axle_count
2
is_trailer
0

上一篇

使用准备

下一篇

更新日志

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