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.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1.00 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
sig | string | No | 仅账号启用了数字签名校验时提供,按高德签名规则计算。 | — |
city | string | Yes | 城市名称、拼音、citycode 或 adcode。 | — |
page | integer | No | 页码,最大 10。 | 1 |
offset | integer | No | 每页记录数;大于 100 时上游按默认值处理。 | 20 |
output | enum (JSON | XML) | No | 响应编码;建议使用 JSON。 | JSON |
keywords | string | Yes | 单个线路名称关键词。 | — |
extensions | enum (base | all) | No | base 返回基本信息;all 同时返回详细信息。 | base |
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_v3_bus_linename' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"city": "110000",
"keywords": "1路",
"offset": 1
}
}'{
"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.

