Amap Maps Get V3 Bus Stopname
Search Amap (高德) for bus stations using a single, nonempty station-name keyword in keywords. Provide city as an adcode or citycode when possible to distinguish stations with the same name in different cities. The response includes matching station records in busstops, a count, and business-status fields. Records may contain station IDs, names, GCJ-02 locations, city and administrative codes, and summaries of serving bus lines, including line IDs, names, types, and start/end stops. offset controls page size (default 20, range 1–100); page selects the page (default 1, range 1–100). extensions supports only base; output supports JSON (default) or XML. sig is needed only for accounts with digital-signature verification enabled. Check status="1" and infocode="10000" for business success even when the HTTP request succeeds.
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 | No | 城市 adcode 或 citycode;推荐提供,避免跨城市同名站点。 | — |
page | integer | No | 页码,最大 100。 | 1 |
offset | integer | No | 每页结果数,最大 100。 | 20 |
output | enum (JSON | XML) | No | 响应编码;建议使用 JSON。 | JSON |
keywords | string | Yes | 单个站点名称关键词。 | — |
extensions | enum (base) | No | 该接口支持 base 基本信息。 | 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_stopname' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"city": "110000",
"keywords": "天安门东",
"offset": 1
}
}'{
"busstops": [
{
"adcode": "110101",
"buslines": [
{
"end_stop": "环球度假区",
"id": "110100023110",
"location": "116.401216,39.907780",
"name": "地铁1号线八通线(苹果园--环球度假区)",
"start_stop": "苹果园"
}
],
"citycode": "010",
"id": "BV10006499",
"location": "116.401216,39.907780",
"name": "天安门东(地铁站)"
}
],
"count": "7",
"info": "OK",
"infocode": "10000",
"status": "1",
"suggestion": {
"cities": [],
"keywords": []
}
}This example shows part of the response. Copied content is valid JSON.

