货车路线规划

GET

/logistics_direction/v1/truck

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://api.map.baidu.com/logistics_direction/v1/truck?origin=22.673186,114.065699&destination=22.6721,114.068886&ak=&sn='

响应示例

{
  "status": 0,
  "message": "string",
  "result": {
    "restriction": {
      "type": "string",
      "info": "string"
    },
    "total": 0,
    "routesinfo_ext": "string",
    "routes": {
      "origin": {
        "lng": 0,
        "lat": 0
      },
      "destination": {
        "lng": 0,
        "lat": 0
      },
      "traffic_light_num": 0,
      "unavoid_statistics": {
        "height": 0,
        "width": 0,
        "weight": 0,
        "plate": 0,
        "road_to_open": 0,
        "road_not_open": 0
      },
      "tag": "string",
      "track_idx": 0,
      "unavoid_polygons_idx": "string",
      "distance": 0,
      "duration": 0,
      "toll": 0,
      "toll_distance": 0,
      "oil_cost": 0,
      "steps": {
        "leg_index": 0,
        "direction": 0,
        "distance": 0,
        "duration": 0,
        "adcodes": "string",
        "road_name": "string",
        "road_type": 0,
        "toll_gate_name": "string",
        "toll_gate_location": {
          "lng": 0,
          "lat": 0
        },
        "start_location": {
          "lng": 0,
          "lat": 0
        },
        "end_location": {
          "lng": 0,
          "lat": 0
        },
        "path": "string",
        "traffic_condition": {
          "status": 0,
          "geo_cnt": 0,
          "distance": 0
        }
      }
    }
  }
}

请求参数

Query 参数

origin

string

必需

起点坐标；格式为：纬度,经度。如：21.22345,112.11478

示例值:

22.673186,114.065699

destination

string

必需

终点坐标；格式与起点坐标相同

示例值:

22.6721,114.068886

height

number

可选

车辆高度；单位：米，取值[0,5.0]，默认1.8，会按照填写数字进行限行规避

示例值:

1.8

width

number

可选

车辆宽度；单位：米，取值[0,3.0]，默认1.9，会按照填写数字进行限行规避

示例值:

1.9

weight

number

可选

车辆总重；车辆总重=车辆自身重量+货物重量，单位：吨，取值[0,100]，默认2.5，会按照填写数字进行限行规避

示例值:

2.5

length

number

可选

车辆长度；单位：米，取值[0,20.0]，默认4.2，会按照填写数字进行限行规避

示例值:

4.2

axle_weight

number

可选

轴重；单位：吨，取值[0,50]，默认2，会按照填写数字进行限行规避

示例值:

axle_count

integer

可选

轴数；取值[0,50]，默认2，会按照填写数字进行限行规避

示例值:

is_trailer

integer

可选

是否是挂车；0：不是(默认) 1：是

示例值:

plate_province

string

可选

车牌号省份；默认：空字串

plate_number

string

可选

车牌号（省份以外号码）；默认：空字串

plate_color

integer

可选

车牌颜色；0：蓝色（默认） 1：黄 2：黑 3：白 4：绿

示例值:

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（国测局加密坐标）

departure_time

array[string]

可选

出发时间；Unix时间戳(秒)，默认为当前时间，支持未来7天内的区间：（now_timestamp - 600, now_timestamp + 7 * 86400）

示例值:

[]

tactics

integer

可选

驾驶策略；0：默认（时间优先） 1：距离优先 3：少走高速 7：经济路线

way_tactics

string

可选

途经点算路时各分段算路偏好；0,1... 各偏好间以逗号分隔，枚举值参考tactics字段说明，且个数为途经点个数+1 如有1个途经点，则需传递2个偏好对应起点→途经点；途经点→终点分段的偏好

alternatives

integer

可选

是否返回备选路线；0：返回一条推荐路线（默认） 1：返回1到3条备选路线

user_mark

string

可选

用户标识；规避自定义区域时的特殊字段格式：大小写字母、数字、英文逗号、英文分号

displacement

integer

可选

百公里油耗，单位mL

vehicle_usages

string

可选

货车用途；如果设置该字段，会根据货车用途进行限行规避如：0,17 0-默认；17-危险物品注意：危化物品功能为高级付费服务，需通过反馈平台联系工作人员开通

power_type

integer

可选

动力类型；默认汽油 0-所有；1-汽油；2-柴油；3-电动；4-混合

truck_type

integer

可选

卡车类型；1-微；2-轻；3-中；4-重；

emission_limit

integer

可选

排放标准；取值范围1-6，对应国1-国6标准

load_weight

integer

可选

核定载重；单位吨[0,1000]

multi

integer

可选

性能模式；0：开启性能模式。在性能模式下，服务耗时会明显缩减，但路线不会考虑当天上线的新交规数据

avoid_type

integer

可选

货车政策交规（如交通部门发布的分时段区域限行政策）剥离；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

integer

可选

是否启用导航；设置该参数，可以支持将货车路线规划API算路结果传入货车导航SDK中并调起导航 1: 启用 0: 关闭默认值为0

disable_ferry

integer

可选

是否禁用轮渡；0: 不对轮渡做限制，可以走轮渡。默认 1: 禁用轮渡交通方式，不再考虑轮渡路线

string

必需

开发者的访问密钥，必填项。v2之前该属性为key。申请秘钥

默认值:

string

可选

可选，若开发者所用AK的校验方式为SN校验时该参数必须。

默认值:

返回响应

🟢200成功

application/json

Body

status

integer

必需

取值范围： 0:成功； 1:服务器内部错误； 2:参数错误更多状态码详见附录

message

string

状态码对应的信息

必需

result

object

返回的结果

必需

restriction

object

必需

车牌限行信息（城市级别）若一条路线触发多个限行，仅返回其中一个

total

integer

返回方案的总数

必需

routesinfo_ext

string

必需

路线扩展信息，如session_id，算路时间等，json结构字符串，原样透传

routes

object

返回的方案集

必需

服务文档

服务介绍