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

文档全面上新

更科技的视觉体验,更高效的页面结构,快前往体验吧!

体验新版
服务介绍
服务文档
使用指南
常见问题
更新日志
物流批量算路

物流批量算路服务(又名Logistics Routematrix API)是一套以HTTP/HTTPS形式提供的轻量级物流批量算路接口,用户可通过该服务,根据多起点和多终点坐标计算路线规划距离和行驶时间,Logistics RouteMatrix API V1.0支持中国境内地区。如需试用请至反馈平台申请开通试用权限,将在1-3个工作日内反馈。

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

功能介绍
货车批量算路

1. 支持全国同城/跨城批量算路,一次请求支持计算50条路线的实际行驶距离和耗时
2. 支持规避物理四限:高、宽、重、轴重
3. 支持根据车牌号规避交规限行,支持区分蓝/黄/白/绿/黑车牌
4. 支持依据实时路况计算路线距离和耗时

5. 支持依据未来3天预测路况和道路限行,规划未来出行距离和耗时
6. 支持多种路线策略选择,包括省钱路线、不走高速、高速优先等策略
接口功能文档
货车路线规划
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
货车批量算路请求参数
参数名称 是否必填 字段类型 含义 备注
origins string 起点坐标串 格式为:纬度,经度|纬度,经度。如:21.22345,112.11478|21.47832,112.37854
注:起终点个数乘积不超过50
destinations string 终点坐标串 格式与起点坐标相同
注:起终点个数乘积不超过50
coord_type string 输入坐标类型 坐标类型,可选参数,默认为bd09ll
允许的值为:
bd09ll(百度经纬度坐标)
bd09mc(百度墨卡托坐标)
gcj02(国测局加密坐标)
wgs84(gps设备获取的坐标)
height double 车辆高度 单位:米,取值[0,5.0],默认1.8,会按照填写数字进行限行规避,字段类型double,单位:米
width double 车辆宽度 单位:米,取值[0,3.0],默认1.9,会按照填写数字进行限行规避,字段类型double,单位:米
weight double 车辆总重 车辆总重=车辆自身重量+货物重量,单位:吨,取值[0,100],默认2.5,会按照填写数字进行限行规避,字段类型double,车辆总重=车辆自身重量+货物重量,单位:吨
length double 车辆长度 单位:米,取值[0,20.0],默认4.2,会按照填写数字进行限行规避,字段类型double,单位:米
axle_weight double 轴重 单位:吨,取值[0,50],默认2,会按照填写数字进行限行规避,字段类型double,单位:吨
axle_count int32 轴数 取值[0,50],默认2,会按照填写数字进行限行规避字段类型int64
is_trailer int32 是否是挂车 0:不是(默认)
1:是
plate_province string 车牌号省份 默认:空字串
plate_number string 车牌号(省份以外号码) 默认:空字串
plate_color int32 车牌颜色 0:蓝色(默认)
1:黄
2:黑
3:白
4:绿
departure_time int32 出发时间 Unix时间戳(秒),默认为当前时间,一期支持未来3天内的区间:(now_timestamp - 600, now_timestamp + 3 * 86400)
tactics int32 驾驶策略 0:默认 (时间优先)
1:距离优先 
3:不走高速
6:少收费
avoid_type int32 货车政策交规(如交通部门发布的分时段区域限行政策)剥离 0:政策交规默认生效;
1:算路时忽略针对货车的政策交规(道路上实体交通标牌限制仍正常生效)
user_mark string 用户标识 规避自定义区域时的特殊字段
格式:大小写字母、数字、英文逗号、英文分号
ak string 用户的AK,授权使用
sn string 用户的权限签名,若用户所用AK的校验方式为SN校验时该参数必须。参考: SN校验
返回参数
参数名 参数含义 字段类型 备注
status 状态码 int32 取值范围:
0:成功;
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:算路请求异常,可以重试一次






使用方法
坐标系说明
WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标
路线规划服务API的输入参数支持以上三种坐标系,开发者无需进行任何坐标转换,通过请求参数"coord_type"指明所使用的坐标系即可。输出参数支持国测局坐标(gcj02)和 百度坐标(bd09ll)两种坐标,通过请求参数"ret_coordtype"进行设置。
服务使用限制

服务相关配额及并发请求限制请访问开发者权益页面查看。

编码说明
API请求中需要用到中文或一些特殊字符的参数,如query、region等,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成UTF-8字符的二字符十六进制值,凡是不在下表中的字符都需要进行编码。
字符集合 字符
URL非保留字
a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~
URL保留字
 ! * ' ( ) ; : @ & = + $ , / ? % # [ ]
如果中文参数中使用URL保留字字符的字面意思,例如:region关键字取值为"?北京",检索关键字包含一个问号,此问号也必须进行编码。
附注:
javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
php中可以使用函数urlencode对特殊字符进行编码。
服务常见问题
1、如何开通试用货车批量算路API

货车批量算路API暂未提供免费配额,如需试用请至反馈平台申请开通试用权限,将在1-3个工作日内反馈。

2019年11月27日

V1.0

产品上线

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

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消