驾车路线规划

GET

/v5/direction/driving

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://restapi.amap.com/v5/direction/driving?origin=&destination&Key='

响应示例

{
  "status": "string",
  "info": "string",
  "infocode": "string",
  "count": "string",
  "route": {
    "origin": "string",
    "destination": "string",
    "paths": {
      "distance": "string",
      "restriction": "string",
      "steps": {
        "instruction": "string",
        "orientation": "string",
        "road_name": "string",
        "step_distance": "string",
        "show_fields": "string",
        "cost": {
          "duration": "string",
          "tolls": "string",
          "toll_distance": "string",
          "toll_road": "string",
          "taxi_fee": "string",
          "traffic_lights": "string",
          "tmcs": {
            "tmc_status": "string",
            "tmc_distance": "string",
            "tmc_polyline": "string",
            "navi": {
              "action": "string",
              "assistant_action": "string",
              "cities": {
                "adcode": "string",
                "citycode": "string",
                "city": "string",
                "district": {
                  "name": "string",
                  "adcode": "string",
                  "polyline": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}

请求参数

Query 参数

origin

string

必需

起点经纬度经度在前，纬度在后，经度和纬度用","分割，经纬度小数点后不得超过6位。

destination

string

必需

经度在前，纬度在后，经度和纬度用","分割，经纬度小数点后不得超过6位。

origin_id

string

可选

起点POI ID 起点为POI时，建议填充此值，可提升路线规划准确性

destination_id

string

可选

目的地POI ID 目的地为POI时，建议填充此值，可提升路线规划准确性

origin_type

string

可选

起点处道路类型填入此值可以辅助更精准的起点算路 0：普通道路 1：高架上 2：高架下 3：主路 4：辅路 5：隧道 7：环岛 9：停车场内部

strategy

string

可选

驾车算路策略 32：默认，高德推荐，同高德地图APP默认 33：躲避拥堵 34：高速优先 35：不走高速 36：少收费 37：大路优先 38：速度最快 39：躲避拥堵＋高速优先 40：躲避拥堵＋不走高速 41：躲避拥堵＋少收费 42：少收费＋不走高速 43：躲避拥堵＋少收费＋不走高速 44：躲避拥堵＋大路优先 45：躲避拥堵＋速度最快

waypoints

string

可选

途经点途径点坐标串，默认支持1个有序途径点。多个途径点坐标按顺序以英文分号;分隔。最大支持16个途经点。

avoidpolygons

string

可选

避让区域区域避让，默认支持1个避让区域，每个区域最多可有16个顶点；多个区域坐标按顺序以英文竖线符号分隔，如果是四边形则有四个坐标点，如果是五边形则有五个坐标点；最大支持32个避让区域。同时传入避让区域及避让道路，仅支持避让道路；每个避让区域不能超过81平方公里，否则避让区域会失效。

avoidroad

string

可选

避让道路名只支持一条避让道路

plate

string

可选

车牌号码车牌号，如京AHA322，支持6位传统车牌和7位新能源车牌，用于判断限行相关。

cartype

string

可选

车辆类型 0：普通燃油汽车 1：纯电动汽车 2：插电式混动汽车

ferry

string

可选

是否使用轮渡 0:使用渡轮 1:不使用渡轮

show_fields

string

可选

返回结果控制 show_fields用来筛选response结果中可选字段。show_fields的使用需要遵循如下规则： 1、具体可指定返回的字段类请见下方返回结果说明中的“show_fields”内字段类型； 2、多个字段间采用“,”进行分割； 3、show_fields未设置时，只返回基础信息类内字段；

sig

string

可选

请参考数字签名获取和使用方法

output

string

可选

返回结果格式类型可选值：JSON

callback

string

可选

回调函数 callback 值是用户定义的函数名称，此参数只在 output 参数设置为 JSON 时有效。

parameters

string

可选

Key

string

必需

用户在高德地图官网申请Web服务API类型Key

默认值:

返回响应

🟢200成功

application/json

Body

status

string

可选

本次API访问状态，如果成功返回1，如果失败返回0。

info

string

可选

访问状态值的说明，如果成功返回"ok"，失败返回错误原因，具体见错误码说明。

infocode

string

可选

返回状态说明,10000代表正确,详情参阅info状态表

count

string

路径规划方案总数

可选

route

object

返回的规划方案列表

可选

origin

string

起点经纬度

可选

destination

string

终点经纬度

可选

paths

object

算路方案详情

可选

概述

步行路线规划