Amap Maps Get V5 Direction Driving

1 credits/call
ae_amap_maps_get_v5_direction_driving

Get detailed driving directions, including turn-by-turn instructions, toll costs, and traffic-aware route options.

MapsTravel
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
ferryenum (0 | 1)No是否使用轮渡 0:使用渡轮 1:不使用渡轮 注意:该参数在 schema 中定义为 string;请按字符串枚举传入,例如 "0"、"1",不要传裸数字 0、1。0
platestringNo车牌号码 车牌号,如 京AHA322,支持6位传统车牌和7位新能源车牌,用于判断限行相关。—
originstringYes起点经纬度 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。—
outputenum (json)No返回结果格式类型 可选值:JSONjson
cartypeenum (0 | 1 | 2)No车辆类型 0:普通燃油汽车 1:纯电动汽车 2:插电式混动汽车 注意:该参数在 schema 中定义为 string;请按字符串枚举传入,例如 "0"、"1",不要传裸数字 0、1。0
callbackstringNo回调函数 callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。—
strategyenum (0 | 1 | 2 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45)No驾车算路策略 32:默认,高德推荐,同高德地图APP默认 33:躲避拥堵 34:高速优先 35:不走高速 极 36:少收费 37:大路优先 38:速度最快 39:躲避拥堵+高速优先 40:躲避拥堵+不走高速 41:躲避拥堵+少收费 42:少收费+不走高速 43:躲避拥堵+少收费+不走高速 44:躲避拥堵+大路优先 45:躲避拥堵+速度最快 注意:该参数在 schema 中定义为 string,即使含义是数字或数字枚举,也请按字符串传入,例如 "1"、"20",不要传裸数字 1、20。32
avoidroadstringNo避让道路名 只支持一条避让道路—
origin_idstringNo起点POI ID 起点为POI时,建议填充此值,可提升路线规划准确性—
waypointsstringNo途经点 途径点坐标串,默认支持1个有序途径点。多个途径点坐标按顺序以英文分号;分隔。最大支持16个途经点。—
destinationstringYes经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。—
show_fieldsstringNo返回结果控制 show_fields用来筛选response结果中可选字段。show_fields的使用需要遵循如下规则: 1、具体可指定返回的字段类请见下方返回结果说明中的“show_fields”内字段类型; 2、多个字段间采用“,”进行分割; 3、show_fields未设置时,只返回基础信息类内字段;—
avoidpolygonsstringNo避让区域 区域避让,默认支持1个避让区域,每个区域最多可有16个顶点;多个区域坐标按顺序以英文竖线符号分隔,如果是四边形则有四个坐标点,如果是五边形则有五个坐标点;最大支持32个避让区域。 同时传入避让区域及避让道路,仅支持避让道路; 每个避让区域不能超过81平方公里,否则避让区域会失效。—
destination_idstringNo目的地POI ID 目的地为POI时,建议填充此值,可提升路线规划准确性—
destination_typestringNo终点POI类别,当用户知道终点POI的类别时,建议填充此值—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_amap_maps_get_v5_direction_driving' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "destination": "121.588711,31.085745",
    "origin": "121.617523,31.186512",
    "plate": "苏E1D234",
    "show_fields": "cost",
    "strategy": "32"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "count": "3",
  "info": "OK",
  "infocode": "10000",
  "route": {
    "destination": "121.588711,31.085745",
    "origin": "121.617523,31.186512",
    "paths": [
      {
        "cost": {
          "duration": "3084",
          "toll_distance": "0",
          "tolls": "0",
          "traffic_lights": "28"
        },
        "distance": "17377",
        "restriction": "0",
        "steps": [
          {
            "cost": {},
            "instruction": "沿卓闻路向东南行驶112米左转",
            "orientation": "东南",
            "road_name": "卓闻路",
            "step_distance": "112"
          }
        ]
      }
    ],
    "taxi_cost": "47"
  },
  "status": "1"
}

This example shows part of the response. Copied content is valid JSON.

Guides using this tool

See how this tool fits into real workflows