“webapi

2019年11月27日 (三) 07:54的版本

服务介绍

服务文档

使用指南

常见问题

更新日志

内容（服务介绍）

物流路线规划服务

物流路线规划服务（又名Logistics Direction API）是一套REST风格的Web服务API，以HTTP/HTTPS形式提供了针对物流行业的路线规划服务。目前，Logistics Direction API支持货车路线规划，覆盖中国境内地区。

功能介绍

货车路线规划

根据起终点坐标检索符合条件的货车驾车路线规划方案，支持以下功能：
1. 支持全国同城/跨城路线规划
2. 支持规避物理四限：高、宽、重、轴重
3. 支持根据车牌号规避交规限行，支持区分蓝/黄/白/绿/黑车牌
4. 支持途径点，最多不超过20个
5. 支持未来出行规划，指定未来3天任意出发时刻，将依据智能预测路况和道路限行规划合理路线
6. 支持多种路线策略选择，包括省钱路线、不走高速、高速优先等策略
7. 支持规避自定义区域

内容（服务文档）

接口功能文档

货车路线规划

http://api.map.baidu.com/logistics_direction/v1/truck  //GET请求

货车规划请求参数

参数名称	是否必填	字段类型	含义	备注
origin	是	string	起点坐标	格式为：纬度,经度。如：21.22345,112.11478
destination	是	string	终点坐标	格式与起点坐标相同
waypoints	否	string	途经点坐标	格式：支持20个以内的有序途径点。多个途径点坐标按顺序以英文竖线符号分隔，示例： 40.465,116.314\|40.232,116.352\|40.121,116.453
coord_type	否	string	输入坐标类型	坐标类型，可选参数，默认为bd09ll 允许的值为： bd09ll（百度经纬度坐标） bd09mc（百度墨卡托坐标） gcj02（国测局加密坐标） wgs84（gps设备获取的坐标）
ret_coordtype	否	string	输出坐标类型	返回结果坐标类型，默认为bd09ll 允许的值为： bd09ll（百度经纬度坐标） gcj02（国测局加密坐标）
height	否	double	车辆高度	单位：米，取值[0,5.0]，默认1.8，会按照填写数字进行限行规避
width	否	double	车辆宽度	单位：米，取值[0,3.0]，默认1.9，会按照填写数字进行限行规避
weight	否	double	车辆总重	车辆总重=车辆自身重量+货物重量，单位：吨，取值[0,100]，默认2.5，会按照填写数字进行限行规避
length	否	double	车辆长度	单位：米，取值[0,20.0]，默认4.2，会按照填写数字进行限行规避
axle_weight	否	double	轴重	单位：吨，取值[0,50]，默认2，会按照填写数字进行限行规避
axle_count	否	int32	轴数	取值[0,50]，默认2，会按照填写数字进行限行规避
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：不走高速 4：高速优先 5：躲避拥堵 6：少收费
alternatives	否	int32	是否返回备选路线	0：返回一条推荐路线（默认） 1：返回1到3条备选路线
alternatives	否	int32	是否返回备选路线	0：返回一条推荐路线（默认） 1：返回1到3条备选路线
user_mark	否	string	用户标识	规避自定义区域时的特殊字段格式：大小写字母、数字、英文逗号、英文分号
displacement	否	int32	百公里油耗，单位mL
power_type	否	int32	动力类型	默认汽油 0-所有；1-汽油；2-柴油；3-电动；4-混合
emission_limit	否	int32	排放标准	取值范围1-6，对应国1-国6标准
load_weight	否	int32	核定载重	单位吨[0,1000]
ak	是	string	用户的AK，授权使用
sn	否	string	用户的权限签名，若用户所用AK的校验方式为SN校验时该参数必须。参考： SN校验

返回参数

字段名称						字段类型	字段含义
status						int32	取值范围： 0:成功； 1:服务器内部错误； 2:参数错误更多状态码详见附录
message						string	状态码对应的信息
result						kv	返回的结果
	restriction					kv	车牌限行信息（城市级别）若一条路线触发多个限行，仅返回其中一个
		type				string	可能取值如下： 0:无限行；1：本地车限行，2：外地车限行，3：本地车尾号限行；4.外地车尾号限行；5其他限行
		info				string	限行信息的文字
	total					int32	返回方案的总数（一期返回1条）
	routes					array	返回的方案集
		origin	lng			double	起点经度
		origin	lat			double	起点纬度
		destination	lng			double	终点经度
		destination	lat			double	终点纬度
		tag				string	方案标签
		distance				double	方案距离，单位：米
		duration				int32	线路耗时，单位：秒（历史eta）
		toll				int32	此路线道路收费，单位：元（一期小客车费用）
		toll_distance				double	收费路段里程，单位：米（一期小客车收费里程）
		oil_cost				double	油费，单位元
		steps				array	路线分段
			leg_index			int32	途径点序号，为从0开始的整数，用于标识step所属的途径点路段如：若该step属于起点至第一个途径中的路段，则其leg_index为0
			direction			int32	进入道路的角度。
			distance			double	step的距离信息
			road_name			string	分段的道路名称
			road_type			int32	分段的道路类型
			toll_distance			double	分段道路收费路程，单位：米
			toll_gate_name			string	收费站名称（一期导航后端保证一个step只返回一个收费站信息）
			toll_gate_location		lng	double	收费站位置：经度
			toll_gate_location		lat	double	收费站位置：纬度
			start_location		lng	double	分段起点经度
			start_location		lat	double	分段起点纬度
			end_location		lng	double	分段终点经度
			end_location		lat	double	分段终点纬度
			path			string	分段坐标
			traffic_condition			array	分段路况详情（填历史路况）
				status		int	路况指数
				geo_cnt		int	从当前坐标点开始，path中路况相同的坐标点个数注：绘制路况时，指标指向第一个path的第一个点，往后数n个点组成的路段路况是一样的，计数时不算指标所在的点（当前step所有geo_cnt的和为path中的点数减1）
				distance		double	距离，从当前坐标点开始path 中路况相同的距离，单位：米

内容（使用指南）

使用方法

坐标系说明

.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，支持货车路线规划。

@@ 第20行： / 第20行： @@
 | style="width: 135px;" | string
 | style="width: 180px;" | 起点坐标
-| style="width: 428px;" | 格式为：纬度,经度。如：21.22345，112.11478
+| style="width: 428px;" | 格式为：纬度,经度。如：21.22345,112.11478
 |-
 | destination
@@ 第152行： / 第152行： @@
 | style="width: 135px;" | int32
 | style="width: 180px;" | 排放标准
-| style="width: 428px;" | 取值范围1-6，对应国1-国6标准<br/>add: 20190912
+| style="width: 428px;" | 取值范围1-6，对应国1-国6标准<br/>
 |-
 | load_weight