驾车路线规划

GET

/direction/v2/driving

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://api.map.baidu.com/direction/v2/driving?origin=40.01116,116.339303&destination=39.936404,116.452562&ak=&sn='

响应示例

{
  "status": "string",
  "message": "string",
  "type": 0,
  "result": {
    "restriction": "string",
    "duration": 0,
    "total": 0,
    "routes": {
      "origin": {
        "lng": 0,
        "lat": 0
      },
      "destination": {
        "lng": 0,
        "lat": 0
      },
      "tag": "string",
      "route_id": "string",
      "distance": 0,
      "duration": 0,
      "ext_duration": 0,
      "suggest_departure_time": 0,
      "taxi_fee": 0,
      "toll": 0,
      "toll_distance": 0,
      "steps": {
        "leg_index": 0,
        "direction": 0,
        "distance": 0,
        "road_name": "string",
        "road_type": "string",
        "toll": 0,
        "toll_distance": 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",
        "adcodes": "string",
        "traffic_condition": {
          "status": 0,
          "geo_cnt": 0,
          "distance": 0
        }
      }
    }
  },
  "end_walkinfo": {
    "distance": 0,
    "path": "string"
  },
  "start_walkinfo": {
    "distance": 0,
    "path": "string"
  }
}

请求参数

Query 参数

origin

string

必需

起点经纬度，格式为：纬度,经度；小数点后不超过6位，40.056878,116.30815

示例值:

40.01116,116.339303

destination

string

必需

终点经纬度，格式为：纬度,经度；小数点后不超过6位，40.056878,116.30815

示例值:

39.936404,116.452562

origin_uid

string

可选

POI 的 uid（在已知起点POI 的 uid 情况下，请尽量填写uid，将提升路线规划的准确性，使用地点检索服务获取uid ，使用地点输入提示服务获取uid )

destination_uid

string

可选

POI 的 uid（在已知终点POI 的 uid 情况下，请尽量填写uid，将提升路线规划的准确性，使用地点检索服务获取uid ，使用地点输入提示服务获取uid )

waypoints

string

可选

途径点坐标串，支持18个以内的有序途径点。多个途径点坐标按顺序以英文竖线符号分隔，示例： 40.465,116.314|40.232,116.352|40.121,116.453

coord_type

string

可选

坐标类型，可选参数，默认为bd09ll。允许的值为：bd09ll（百度经纬度坐标）、bd09mc（百度墨卡托坐标）、gcj02（国测局加密坐标）、wgs84（gps设备获取的坐标）。

示例值:

bd09II

ret_coordtype

string

可选

返回结果坐标类型，默认为bd09ll，允许的值为：bd09ll（百度经纬度坐标）、gcj02（国测局加密坐标）

示例值:

bd09II

tactics

integer

可选

0：默认 2：距离最短（只返回一条路线，不考虑限行和路况，距离最短且稳定，用于估价场景） 3：不走高速 4：高速优先 5：躲避拥堵 6：少收费 7: 躲避拥堵 & 高速优先 8: 躲避拥堵 & 不走高速 9: 躲避拥堵 & 少收费 10: 躲避拥堵 & 不走高速 & 少收费 11: 不走高速 & 少收费 12: 距离优先（考虑限行和路况，距离相对短且不一定稳定） 13：时间优先

示例值:

alternatives

string

可选

是否返回备选路线类型：string 可选值： 0：返回一条推荐路线 1：返回1-3条路线供选择

示例值:

cartype

integer

可选

车辆类型，区分车辆是普通燃油车或纯电动汽车。由于部分城市对燃油车和电动车限行规则有差异，该字段用于结合plate_number车牌号来规避限行。例如：纯电动汽车在北京本地无尾号限行，而燃油车需遵守尾号限行。可选值： 0：普通汽车 1：纯电动汽车

示例值:

plate_number

string

可选

牌号，如京A00022 用于规避车牌号限行路段。 1、若有规避限行区域的可选路线，则返回规避后的路线，不会返回限行路线 2、若无规避限行的可选路线（如：起终点在限行区域内，或所有符合偏好的路线都无法规避限行区域），则返回限行路线中最优路线，并在返回字段 restriction 中提示用户路段被限行；不填则不作规避

departure_time

string

可选

设置出发时间（支持未来7天），UNIX时间戳。该字段将影响duration字段的返回，用于返回未来驾车路线耗时。取值范围：当前时间之后7天*24小时内任意时刻（超出时间范围将预估路线）若设置该参数，则路线规划服务将依据设定时间预测路况和限行规则，并据此计算路线和耗时；默认为当前时间注意：该功能为高级付费服务，需通过反馈平台联系工作人员开通

ext_departure_time

string

可选

更多出发时间，UNIX时间戳。该字段将影响ext_duration字段的返回，用于返回驾车路线历史耗时（路线在指定出发时间的耗时）。目前支持输入过去7天内一个或多个出发时间戳（不超过12个），多个时间戳之间用","英文半角逗号隔开。示例： ext_departure_time=1526527619� ext_departure_time=1526527619,1526525384,1526523654�� 注：目前出发时间仅影响ext_duration字段，还不会影响路线计算和选择。即仍按照现在的路况计算并推荐路线，但将增加返回该路线在其他时间的耗时；不填则不返回ext_duration字段注意：该功能为高级付费服务，需通过反馈平台联系工作人员开通

expect_arrival_time

string

可选

预期的到达时间，UNIX时间戳。该字段将影响suggest_departure_time字段的返回，用于返回建议出发时间。取值范围：当前时间之后15分钟的任意时刻（小于这个时间则不做处理）若设置此参数，则路线规划服务将依据设定时间计算路线和耗时，并给出建议出发时间若算出的suggest_departure_time小于当前时间，则设置suggest_departure_time为-1；不填则不返回suggest_departure_time字段注意：该功能为高级付费服务，需通过反馈平台联系工作人员开通

gps_direction

integer

可选

起点的车头方向。字段类型：int64 取值范围：0-359；车头方向为与正北方向顺时针夹角，该参数用于辅助判断起点所在正逆向车道，提高算路准确率。当speed>1.5米/秒且gps_direction存在时，采用该方向。gps_direction并不代表需填写从gps获取的方向，可以填入校正后的方向。请填写尽量准确的方向，其准确性很大程度决定了计算的精度。

radius

number

可选

起点的定位精度，字段类型：float，取值范围[0,2000]；配合gps_direction字段使用

speed

number

可选

起点车辆的行驶速度，字段类型：float；单位：米/秒，配合gps_direction字段使用，当speed>1.5米/秒且gps_direction存在时，采用gps_direction的方向。

output

string

可选

表示输出类型，可设置为xml或json

timestamp

integer

可选

时间戳，与SN配合使用

callback

string

可选

回调函数；仅在output=json时，该参数有效

intelligent_plan

integer

可选

传入多个途经点，综合考虑路况、交规限行、途经点的相对位置以及路线整体的绕路成本等，支持智能调整途经点顺序，给出最优路线。可选值： 0（默认值）：不执行途经点智能规划 1：执行途经点智能规划；默认0：不执行途经点智能规划注意：该功能为高级付费服务，需通过反馈平台联系工作人员开通

walkinfo

integer

可选

起终点步导路线；1 表示下发起终点步导路线； 0 不下发起终点步导路线；默认值为0

string

必需

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

默认值:

string

可选

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

默认值:

返回响应

🟢200成功

application/json

Body

status

string

必需

状态码； 0：成功 1：服务内部错误 2：参数无效 7：无返回结果

message

string

状态码对应的信息

必需

type

integer

必需

默认返回2，开发者无需关注

result

object

返回的结果

必需

restriction

string

必需

限行结果提示信息若无限行路线，则返回空若无法规避限行，则返回限行提示信息

duration

integer

必需

step的耗时；单位秒

total

integer

返回方案的总数

必需

routes

object

必需

返回的方案集；若请求参数设置了符合规则的departure_time，则按照设定时间的预测路况和限行规则计算路线。
若未设置departure_time，则按照当前时刻的路况和限行规则计算路线

end_walkinfo

object

终点步导路线

必需

distance

integer

必需

终点步导路线距离；单位米

path

string

终点步导路线坐标点

必需

start_walkinfo

object

起点步导路线

必需

distance

integer

必需

终点步导路线距离，单位米

path

string

终点步导路线坐标点

必需

骑行路线规划

服务介绍