Ae · Amap · Maps · Get · V5 · Direction · Driving

1.00积分/次
ae_amap_maps_get_v5_direction_driving

获取详细的驾车路线,包括逐向导航指令、过路费及考虑实时路况的路线选项。

地图旅行
1.00积分/次

价格说明

1.00积分/次

API 调用

通过统一工具网关发起同步请求,鉴权和计费由 AgentEarth 处理。

cURL
curl --request POST \
  --url 'https://api.agentearth.ai/v1/tools/run' \
  --header 'Authorization: Bearer $AGENTEARTH_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "tool": "ae_amap_maps_get_v5_direction_driving",
  "input": {
    "ferry": "0",
    "plate": "xxx",
    "origin": "xxx",
    "output": "json",
    "cartype": "0",
    "callback": "xxx",
    "strategy": "32",
    "avoidroad": "xxx",
    "origin_id": "xxx",
    "waypoints": "xxx",
    "destination": "xxx",
    "show_fields": "xxx",
    "avoidpolygons": "xxx",
    "destination_id": "xxx",
    "destination_type": "xxx"
  }
}'
请求方式
POST
接口地址
/v1/tools/run
鉴权方式
Bearer Token
超时时间
60 秒
当前版本
—
响应示例
{
  "error_no": 0,
  "error_msg": "",
  "result": [
    {
      "type": "text",
      "text": "xxx"
    }
  ],
  "platform_annotations": {
    "source": "AgentEarth",
    "platform_note": "xxx",
    "platform_suggestion": "xxx"
  }
}

工具参数

未传入的可选参数将使用平台默认值。

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