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"
}
}工具参数
未传入的可选参数将使用平台默认值。
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
ferry | enum (0 | 1) | 否 | 是否使用轮渡 0:使用渡轮 1:不使用渡轮 注意:该参数在 schema 中定义为 string;请按字符串枚举传入,例如 "0"、"1",不要传裸数字 0、1。 | 0 |
plate | string | 否 | 车牌号码 车牌号,如 京AHA322,支持6位传统车牌和7位新能源车牌,用于判断限行相关。 | — |
origin | string | 是 | 起点经纬度 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。 | — |
output | enum (json) | 否 | 返回结果格式类型 可选值:JSON | json |
cartype | enum (0 | 1 | 2) | 否 | 车辆类型 0:普通燃油汽车 1:纯电动汽车 2:插电式混动汽车 注意:该参数在 schema 中定义为 string;请按字符串枚举传入,例如 "0"、"1",不要传裸数字 0、1。 | 0 |
callback | string | 否 | 回调函数 callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。 | — |
strategy | enum (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 |
avoidroad | string | 否 | 避让道路名 只支持一条避让道路 | — |
origin_id | string | 否 | 起点POI ID 起点为POI时,建议填充此值,可提升路线规划准确性 | — |
waypoints | string | 否 | 途经点 途径点坐标串,默认支持1个有序途径点。多个途径点坐标按顺序以英文分号;分隔。最大支持16个途经点。 | — |
destination | string | 是 | 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。 | — |
show_fields | string | 否 | 返回结果控制 show_fields用来筛选response结果中可选字段。show_fields的使用需要遵循如下规则: 1、具体可指定返回的字段类请见下方返回结果说明中的“show_fields”内字段类型; 2、多个字段间采用“,”进行分割; 3、show_fields未设置时,只返回基础信息类内字段; | — |
avoidpolygons | string | 否 | 避让区域 区域避让,默认支持1个避让区域,每个区域最多可有16个顶点;多个区域坐标按顺序以英文竖线符号分隔,如果是四边形则有四个坐标点,如果是五边形则有五个坐标点;最大支持32个避让区域。 同时传入避让区域及避让道路,仅支持避让道路; 每个避让区域不能超过81平方公里,否则避让区域会失效。 | — |
destination_id | string | 否 | 目的地POI ID 目的地为POI时,建议填充此值,可提升路线规划准确性 | — |
destination_type | string | 否 | 终点POI类别,当用户知道终点POI的类别时,建议填充此值 | — |
