Amap Maps Get V5 Direction Transit Integrated

1.00 credits/call
ae_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.

Maps
1.00 credits/call

Pricing

1.00 credits/call
ConditionCharge
Each call1.00 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
ad1stringNo起点行政区 adcode。—
ad2stringNo终点行政区 adcode。—
sigstringNo仅账号启用了数字签名校验时提供,按高德签名规则计算。—
datestringNo出行日期,YYYY-MM-DD。—
timestringNo出行时间,遵循高德文档示例的时分格式,例如 9-54。—
city1stringYes起点 citycode,同城也须提供两端编码。—
city2stringYes终点 citycode。—
originstringYesGCJ-02 经度,纬度;各最多六位小数。—
outputenum (json)No返回 JSON。json
callbackstringNo可选 JSONP 回调名称;服务端工具调用通常不需要设置。—
strategyintegerNo0 推荐;1 经济;2 少换乘;3 少步行;4 舒适;5 不乘地铁;6 地铁图;7 地铁优先;8 时间短。0
nightflagenum (0 | 1)No是否考虑夜班车,0 否、1 是。0
originpoistringNo起点 POI ID,必须与 destinationpoi 成组使用。—
destinationstringYesGCJ-02 经度,纬度;各最多六位小数。—
show_fieldsstringNo按官方返回字段组控制可选数据,多组以英文逗号分隔;省略时只返回基本结果。—
destinationpoistringNo终点 POI ID,必须与 originpoi 成组使用。—
AlternativeRouteintegerNo返回不同方案的数量,参数名 A/R 大小写按高德原接口保留。5

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_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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.