摩托车路线规划

GET

/direction/v2/motorcycle

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://api.map.baidu.com/direction/v2/motorcycle?origin=4846797.3,12948640.7&ak=&sn='

响应示例

{
  "status": 0,
  "message": "string",
  "result": {
    "restriction": "string",
    "total": 0,
    "routes": {
      "origin": {
        "lng": 0,
        "lat": 0
      },
      "destination": {
        "lng": 0,
        "lat": 0
      },
      "tag": "string",
      "restriction_info": {
        "status": 0,
        "desc": "string"
      },
      "distance": 0,
      "duration": 0,
      "taxi_fee": 0,
      "toll": 0,
      "toll_distance": 0,
      "steps": {
        "leg_index": 0,
        "direction": 0,
        "distance": 0,
        "road_name": "string",
        "road_type": 0,
        "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
        }
      }
    }
  }
}

请求参数

Query 参数

origin

string

必需

支持以下对起点的描述: 1. 起点经纬度，小数点后不超过6位， 40.056878,116.30815(若使用POI 的导航坐标即XXXX，将会提升路线规划的准确性) 2. 名称(该参数仅对sdk和js api开放)；起点和终点的直线距离不得超过400km

示例值:

4846797.3,12948640.7

destination

string

可选

支持以下对终点的描述：终点经纬度，小数点后不超过6位，40.056878,116.30815（若使用POI 的导航坐标即XXXX，将会提升路线规划的准确性）名称（该参数仅对sdk和js api开放）；起点和终点的直线距离不得超过400km

示例值:

4836829.84,12967554.88

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

示例值:

bd09mc

ret_coordtype

string

可选

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

tactics

integer

可选

0：默认 3：不走高速 4：高速优先 5：躲避拥堵 6：少收费 7：躲避拥堵&高速优先 8：躲避拥堵&不走高速 9：躲避拥堵&少收费 10：躲避拥堵&不走高速&少收费 11：不走高速&少收费；默认0:默认策略

alternatives

integer

可选

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

plate_number

string

可选

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

displacement

integer

可选

摩托车排量，单位cc；取值范围【0，10000】

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时，该参数有效

string

必需

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

默认值:

string

可选

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

默认值:

返回响应

🟢200成功

application/json

Body

status

integer

必需

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

message

string

状态码对应的信息

必需

result

object

返回的结果

必需

restriction

string

必需

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

total

integer

返回方案的总数

必需

routes

object

必需

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

服务文档

公交路线规划