服务介绍

服务文档

使用指南

常见问题

更新日志

内容（服务介绍）

物流批量算路

物流批量算路服务（又名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：算路请求异常，可以重试一次

内容（使用指南）

使用方法

1 注册百度账号

2 申请成为百度开发者

3 获取密钥（AK）

4 发送请求，使用服务

坐标系说明

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. 支持规避自定义区域