浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
服务介绍
服务文档
使用指南
常见问题
更新日志
物流路线规划服务

物流路线规划服务(又名Logistics Direction API)是一套REST风格的Web服务API,以HTTP/HTTPS形式提供了针对物流行业的路线规划服务。目前,Logistics Direction API支持货车路线规划,覆盖中国境内地区。如需试用请至反馈平台申请开通试用权限,将在1-3个工作日内反馈。

功能介绍
货车路线规划
根据起终点坐标检索符合条件的货车驾车路线规划方案,支持以下功能:
1. 支持全国同城/跨城路线规划
2. 支持规避物理限制:高、宽、重、轴重
3. 支持根据车牌号规避交规限行,支持区分蓝/黄/白/绿/黑车牌
4. 支持途径点,最多不超过20个
5. 支持未来出行规划,指定未来3天任意出发时刻,将依据智能预测路况和道路限行规划合理路线
6.支持多种路线策略选择,包括经济路线、距离优先、时间优先、不走高速策略
7. 支持规避指定道路、自定义区域
8.支持传入经验路线
接口功能文档
货车路线规划
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)
eta_timestamp int32 ETA时间戳 0:实时ETA

1:静态ETA(历史均值)

未来时间戳:返回未来(历史) ETA (now_timestamp - 600, now_timestamp + 7 * 86400) 其他时间返回参数错误

注:根据departure_time算路,只是返回的duration按次字段规定填充

tactics int32 驾驶策略 0:默认 (时间优先)
1:距离优先
3:不走高速
7:经济路线
// 其他暂不支持
4:高速优先
5:躲避拥堵
6:少收费
way_tactics string 途经点算路时各分段算路偏好 0,1...
各偏好间以逗号分隔,枚举值参考tactics字段说明,且个数为 途经点个数+1
如有1个途经点,则需传递2个偏好对应 起点→途经点; 途经点→终点 分段的偏好
alternatives int32 是否返回备选路线 0:返回一条推荐路线 (默认)
1:返回1到3条备选路线
avoid_polygons
string
避让区域

lat,lng;lat,lng;..|lat,lng;lat,lng;...|...

最多支持100个避让区域,每个区域最多可有16个顶点,坐标点按逆时针方向组织

坐标类型受参数coord_type约定

如果传递此参数,则必须采用post方式发送Http请求,header中content-type设置为application/x-www-form-urlencoded,并且所有参数放置在body中进行发送

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]
experience_track string 用户指定经验轨迹 lat,lng,timestamp;lat,lng,timestamp;lat,lng,timestamp ’|‘ lat,lng,timestamp;lat,lng,timestamp.....

轨迹点间英文分号分割,分段轨迹间以英文竖线分割,轨迹分段最多3个

如无时间戳可设置为0,所有轨迹点个数<2000。坐标类型受参数coord_type约定

如果传递此参数,则必须采用post方式发送Http请求

注意:该功能为高级付费服务,需通过反馈平台联系工作人员开通

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 返回方案的总数
routes array 返回的方案集
origin lng double 起点经度
lat double 起点纬度
destination lng double 终点经度
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 进入道路的角度。

枚举值,返回值在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°] 注:角度为与正北方向顺时针夹角

distance double step的距离信息,单位:米
duration int32 线路耗时,单位:秒

若选择实时ETA,则返回考虑实时路况的ETA

若选择静态ETA,则返回一个历史估值ETA

adcodes string 经过的城市列表,市级,英文逗号分隔
road_name string 分段的道路名称
road_type int32 分段的道路类型 枚举值:返回0-9之间的值

0:高速路
1:城市高速路
2: 国道
3:省道
4:县道
5:乡镇村道
6:其他道路
7:九级路
8:航线(轮渡)
9:行人道路

toll_gate_name string 收费站名称
toll_gate_location lng double 收费站位置:经度
lat double 收费站位置:纬度
start_location lng double 分段起点经度
lat double 分段起点纬度
end_location lng double 分段终点经度
lat double 分段终点纬度
path string 分段坐标
traffic_condition array 分段路况详情(填历史路况)
status int 路况指数 
0 无路况数据  1 畅通 2 缓行 3 拥堵 4 严重拥堵 
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

2020年02月13日

V1.0.1

2020年03月19日

V1.0.2

2020年04月30日

V1.0.3

产品上线

开放物流路线规划V1.0,支持货车路线规划。

产品更新

1、货车路线规划新增经济路线,字段tactics新增请求参数7(经济路线),综合考虑货车运输各项成本,输出综合成本最低的经济路线,帮助企业节省运输费用。

2、货车路线规划新增返回1-3条备选路线,字段alternatives新增参数1(返回1到3条备选路线),支持返回同一策略下最多3条备选路线,方便企业能够集合自身运输业务制定灵活的调度计划。

产品上线

1、货车路线规划新增经验路线规划,用户可以通过字段experience_track,传入指定的经验轨迹,开通货车导航服务后,可按照经验路线进行导航

产品上线

1、货车路线规划新增途经点分段算路偏好,用户可以通过字段way_tactics设置由于途经点形成的多个分段路线算路偏好

2、货车路线规划支持返回路线途径城市,用户可以通过字段adcodes获得途经城市列表

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

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

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消