物流路线规划服务（又名Logistics Direction API）是一套REST风格的Web服务API，以HTTP/HTTPS形式提供了针对物流行业的路线规划服务。目前，Logistics Direction API支持货车路线规划，覆盖中国境内地区。如需试用请至反馈平台申请开通试用权限，将在1-3个工作日内反馈。
注意：货车路线规划请求算路结果会和请求时间相关，请求时间不同可能触发不同时段的相关限行政策信息。若用于未来时间的调度场景，请注意请求服务时间
段与运输时间段尽量相同。
1. 支持全国同城/跨城路线规划
2. 支持规避物理限制：高、宽、重、轴重
3. 支持根据车牌号规避交规限行，支持区分蓝/黄/白/绿/黑车牌
4. 支持途径点，最多不超过20个
5. 支持未来出行规划，指定未来7天任意出发时刻，将依据智能预测路况和道路限行规划合理路线
6.支持多种路线策略选择，包括经济路线、距离优先、时间优先、不走高速策略
7.支持传入经验路线
https://api.map.baidu.com/logistics_direction/v1/truck?origin=22.673186,114.065699&destination=22.6721,114.068886&height=1.8&width=1.9&weight=2.5&length=4.2&axle_weight=2&axle_count=2&is_trailer=0&plate_province=&plate_number=&plate_color=0&ak=你的AK
| 参数名称 | 是否必填 | 字段类型 | 含义 | 备注 |
|---|---|---|---|---|
| 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时间戳(秒)，默认为当前时间，支持未来7天内的区间：（now_timestamp - 600, now_timestamp + 7 * 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：经济路线 |
| way_tactics | 否 | string | 途经点算路时各分段算路偏好 | 0,1... 各偏好间以逗号分隔，枚举值参考tactics字段说明，且个数为 途经点个数+1 如有1个途经点，则需传递2个偏好对应 起点→途经点； 途经点→终点 分段的偏好 |
| alternatives | 否 | int32 | 是否返回备选路线 | 0：返回一条推荐路线 （默认） 1：返回1到3条备选路线 |
| user_mark | 否 | string | 用户标识 | 规避自定义区域时的特殊字段 格式：大小写字母、数字、英文逗号、英文分号 |
| displacement | 否 | int32 | 百公里油耗，单位mL | |
|
vehicle_usages |
否 |
string |
货车用途 |
如果设置该字段，会根据货车用途进行限行规避 如：0,17 0-默认；17-危险物品 注意：危化物品功能为高级付费服务，需通过反馈平台联系工作人员开通 |
| power_type | 否 | int32 | 动力类型 | 默认汽油 0-所有；1-汽油；2-柴油；3-电动；4-混合 |
| truck_type | 否 | int32 | 卡车类型 | 1-微；2-轻；3-中；4-重； |
| emission_limit | 否 | int32 | 排放标准 | 取值范围1-6，对应国1-国6标准 |
| load_weight | 否 | int32 | 核定载重 | 单位吨[0,1000] |
| avoid_type | 否 | int32 | 货车政策交规（如交通部门发布的分时段区域限行政策）剥离 | 0：政策交规默认生效； 1：算路时忽略针对货车的政策交规（道路上实体交通标牌限制仍正常生效） |
| experience_track | 否 | string | 用户指定经验轨迹 | lat,lng,timestamp;lat,lng,timestamp;lat,lng,timestamp .....
轨迹点间英文分号分割 如无时间戳可设置为0，所有轨迹点个数<2000。坐标类型受参数coord_type约定 如果传递此参数，则必须采用post方式发送Http请求，header中content-type设置为application/x-www-form-urlencoded，并且所有参数放置在body中进行发送 注意：该功能为高级付费服务，需通过反馈平台联系工作人员开通 |
|
navigable |
否 |
int64 |
是否启用导航 |
设置该参数，可以支持将货车路线规划API算路结果传入货车导航SDK中并调起导航 1: 启用 0: 关闭 默认值为0 |
|
disable_ferry |
否 |
int32 |
是否禁用轮渡 |
0: 不对轮渡做限制，可以走轮渡。默认 1: 禁用轮渡交通方式，不再考虑轮渡路线 |
| 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 | 返回方案的总数 | ||||||
| routesinfo_ext |
string |
路线扩展信息，如session_id，算路时间等，json结构字符串，原样透传 | ||||||
| routes | array | 返回的方案集 | ||||||
| origin | lng | double | 起点经度 | |||||
| lat | double | 起点纬度 | ||||||
| destination | lng | double | 终点经度 | |||||
| lat | double | 终点纬度 | ||||||
|
traffic_light_num |
int | 红绿灯个数 | ||||||
|
unavoid_statistics |
|
本条线路未规避信息汇总 注意：未规避信息为高级付费服务，需通过反馈平台联系工作人员开通 | ||||||
|
|
height |
|
|
|
int |
限高个数 | ||
|
|
width |
|
|
|
int |
限宽个数 | ||
|
|
weight |
|
|
|
int |
限重个数 | ||
|
|
plate |
|
|
|
int |
货车标牌个数 | ||
|
|
road_to_open |
|
|
|
int |
即将开通道路数 | ||
|
|
road_not_open |
|
|
|
int | 阻断道路数 | ||
| tag | string | 方案标签 | ||||||
| track_idx |
int32 |
轨迹索引，和输入的多段经验轨迹对应，说明此路线是参考哪个经验轨迹点计算的 -1: 不参考经验轨迹点计算的路线 >=0: 和经验轨迹点对应，索引从0开始 | ||||||
| unavoid_polygons_idx |
string |
未规避的避让区域索引，从0开始，如都已规避，则返回空字符串 | ||||||
| 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：高速路 | ||||||
| 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 中路况相同的距离，单位：米 | ||||||
GCJ02：是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
BD09：为百度坐标系，在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托米制坐标
路线规划服务API的输入参数支持以上三种坐标系，开发者无需进行任何坐标转换，通过请求参数"coord_type"指明所使用的坐标系即可。输出参数支持国测局坐标（gcj02）和 百度坐标（bd09ll）两种坐标，通过请求参数"ret_coordtype"进行设置。
服务相关配额及并发请求限制请访问开发者权益页面查看。
| 字符集合 | 字符 |
| 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保留字 |
! * ' ( ) ; : @ & = + $ , / ? % # [ ] |
附注：
javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
php中可以使用函数urlencode对特殊字符进行编码。
货车路线规划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获得途经城市列表