Amap Maps Get V3 Bus Linename

1.00 credits/call
ae_amap_maps_get_v3_bus_linename

Search Amap (高德) bus or metro lines using one line-name keyword and a city. Both keywords and city are required and nonempty; city may be a name, pinyin, citycode, or adcode. Results include matching line records, a count, and business status information. Records may contain line IDs, names, and start/end stops; set extensions=all to request details such as ordered stops and operating information, where available. The default base mode returns basic information. Optional offset (1–100, default 20) and page (1–10, default 1) control pagination. Output defaults to JSON and also supports XML; sig is needed only when account-level signature validation is enabled. Check status=1 and infocode=10000 for business success even when HTTP succeeds. This tool looks up lines; it does not plan point-to-point journeys or track vehicles in real time.

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
sigstringNo仅账号启用了数字签名校验时提供,按高德签名规则计算。—
citystringYes城市名称、拼音、citycode 或 adcode。—
pageintegerNo页码,最大 10。1
offsetintegerNo每页记录数;大于 100 时上游按默认值处理。20
outputenum (JSON | XML)No响应编码;建议使用 JSON。JSON
keywordsstringYes单个线路名称关键词。—
extensionsenum (base | all)Nobase 返回基本信息;all 同时返回详细信息。base

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_v3_bus_linename' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "city": "110000",
    "keywords": "1路",
    "offset": 1
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "buslines": [
    {
      "id": "900000258460",
      "name": "1路(首钢园公交场站--四惠枢纽站)",
      "type": "普通公交"
    }
  ],
  "count": "77",
  "info": "OK",
  "infocode": "10000",
  "status": "1"
}

This example shows part of the response. Copied content is valid JSON.