Amap Maps Get V5 Direction Transit Integrated
Plan bus and metro journeys with Amap (Gaode), including walking connections and transfer legs. Provide origin and destination as GCJ-02 longitude,latitude coordinates (up to six decimal places each), and city1 and city2 citycodes, including for journeys within the same city. If using originpoi or destinationpoi, provide both; both are required for strategy=6. Optional settings include route preferences, alternative count, night services, travel date/time and additional response field groups. Returns business status, result count and transit itineraries, with walking and transport segments and distance, duration or cost details where supplied by Amap. Optional details depend on show_fields and the provider response. Check status="1" and infocode="10000" for business success; HTTP success alone is insufficient.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1.00 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
ad1 | string | No | 起点行政区 adcode。 | — |
ad2 | string | No | 终点行政区 adcode。 | — |
sig | string | No | 仅账号启用了数字签名校验时提供,按高德签名规则计算。 | — |
date | string | No | 出行日期,YYYY-MM-DD。 | — |
time | string | No | 出行时间,遵循高德文档示例的时分格式,例如 9-54。 | — |
city1 | string | Yes | 起点 citycode,同城也须提供两端编码。 | — |
city2 | string | Yes | 终点 citycode。 | — |
origin | string | Yes | GCJ-02 经度,纬度;各最多六位小数。 | — |
output | enum (json) | No | 返回 JSON。 | json |
callback | string | No | 可选 JSONP 回调名称;服务端工具调用通常不需要设置。 | — |
strategy | integer | No | 0 推荐;1 经济;2 少换乘;3 少步行;4 舒适;5 不乘地铁;6 地铁图;7 地铁优先;8 时间短。 | 0 |
nightflag | enum (0 | 1) | No | 是否考虑夜班车,0 否、1 是。 | 0 |
originpoi | string | No | 起点 POI ID,必须与 destinationpoi 成组使用。 | — |
destination | string | Yes | GCJ-02 经度,纬度;各最多六位小数。 | — |
show_fields | string | No | 按官方返回字段组控制可选数据,多组以英文逗号分隔;省略时只返回基本结果。 | — |
destinationpoi | string | No | 终点 POI ID,必须与 originpoi 成组使用。 | — |
AlternativeRoute | integer | No | 返回不同方案的数量,参数名 A/R 大小写按高德原接口保留。 | 5 |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_amap_maps_get_v5_direction_transit_integrated' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"AlternativeRoute": 3,
"city1": "0512",
"city2": "0512",
"date": "2026-11-13",
"destination": "121.027039,31.265754",
"destinationpoi": "B020017RNO",
"origin": "120.950113,31.352682",
"originpoi": "B020016FSS",
"output": "json",
"show_fields": "cost,taxi_fare,walking,railway",
"strategy": 0,
"time": "14-30"
}
}'{
"count": "2",
"info": "OK",
"infocode": "10000",
"route": {
"cost": {},
"destination": "121.026299,31.266863",
"distance": "16974",
"origin": "120.951286,31.352337",
"transits": [
{
"cost": {
"duration": "5178",
"transit_fee": "3.0"
},
"distance": "19736",
"nightflag": "0",
"segments": [
{
"bus": {},
"walking": {}
}
],
"walking_distance": "1724"
}
]
},
"status": "1"
}This example shows part of the response. Copied content is valid JSON.

