List supported cities
bus_list_citiesRead-onlyIdempotent
Retrieve a list of cities with realtime bus data, including city IDs. Use to convert user-mentioned city names into the correct identifier for queries.
Instructions
List cities supported by the realtime bus data service.
Args:
hot_only (boolean, default true): return only the upstream's curated 'hot' set (~20 cities). Set false to dump the full ~480-city list (token-heavy, use sparingly).
response_format ('markdown' | 'json'): defaults to 'markdown'
Returns (json): { "cities": [ { "cityId": "034", "cityName": "上海", "pinyin": "ShangHai", "supportSubway": true, "hot": true }, ... ] }
Use when: the user mentions a city name and you don't have its ID. The hot set covers the top-tier cities the user almost certainly means.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hot_only | No | Default true: return only the upstream-curated 'hot' set (~20 cities). Set false to dump all 480+. | |
| response_format | No | Output format: 'markdown' for human-readable text, 'json' for full structured data | markdown |