Ae · Amap · Maps · Get · V3 · Distance
1.00积分/次
ae_amap_maps_get_v3_distance
计算地点之间的距离和预计行程时间。支持直线、驾车和步行模式。 重要：实际链路可以这样用：先调 amap_maps_get_v3_geocode_geo，把“北京大学”“上海虹桥站”“北京市朝阳区阜通东大街6号”等地址/地点转成 lng,lat；再把得到的坐标传给 amap_maps_get_v3_distance，例如 origins=116.xxx,39.xxx，destination=121.xxx,31.xxx。相关工具：amap_maps_get_v3_place_text 是 POI 关键字搜索，也会返回地点坐标，适合搜商铺/景点/地标；amap_maps_get_v3_geocode_regeo 是逆地理编码，经纬度 -> 地址；amap_maps_get_v3_assistant_coordinate_convert 用于坐标系转换，比如 GPS/百度坐标转高德坐标。
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_v3_distance",
"input": {
"type": "1",
"output": "JSON",
"origins": "xxx",
"callback": "xxx",
"destination": "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"
}
}工具参数
未传入的可选参数将使用平台默认值。
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
type | enum (0 | 1 | 3) | 否 | 路径计算的方式和方法 0：直线距离 1：驾车导航距离（仅支持国内坐标）。 必须指出，当为1时会考虑路况，故在不同时间请求返回结果可能不同。 此策略和驾车路径规划接口的 strategy=0策略基本一致，策略为“ 速度优先，此路线不一定距离最短 ” 由于算法差异，无法保证距离测量结果与路径规划结果完全一致。若需要实现高德地图客户端效果，可以考虑使用驾车路径规划接口 3：步行规划距离（仅支持5km之间的距离） 注意：该参数在 schema 中定义为 string；请按字符串枚举传入，例如 "0"、"1"，不要传裸数字 0、1。 | 1 |
output | enum (JSON | XML) | 否 | 返回数据格式类型 可选值：JSON，XML | JSON |
origins | string | 是 | 出发点 支持100个坐标对，坐标对见用“| ”分隔；经度和纬度用","分隔 | — |
callback | string | 否 | 回调函数 callback值是用户定义的函数名称，此参数只在output=JSON时有效 | — |
destination | string | 是 | 目的地 规则： lon，lat（经度，纬度）， “,”分割 如117.500244, 40.417801 经纬度小数点不超过6位 | — |