加载接口文档…
实时公交到站
API按官方城市名和官方站名，查询该站各公交线路的实时到站信息。返回车牌、预计到站时间、剩余站数、票价和终点方向。本接口免费，覆盖全国数百个城市。 查询前请核对名称 到站查询使用的城市名、站名，须与本接口给出的官方名称一致。地图软件中的「五一广场（地铁站）」不能直接用于到站查询。请先搜…
由 极数本源 提供·更新于 今天
3.7M
累计调用
350ms
平均响应
100.00%
服务可用性
1,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每天 500 次 · QPS 5
登录免费
当前方案每天 1,000 次 · QPS 10
黄金会员
每天 50,000 次 · QPS 20
钻石会员
每天 100,000 次 · QPS 30
企业会员
每天 1,000,000 次 · QPS 120
接入文档
接口请求地址
https://v1.apizero.cn/api/bus-realtime
接口请求方式
POST
请求参数格式
APPLICATION/JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/bus-realtime?type=line-search&city=%E9%95%BF%E6%B2%99&line=1
接口信息备注
按路号或线路名列出该城市命中的多条线路，不要求唯一。1 会同时出现 1路、11路。line 留空则列出该城可查线路（最多 80 条）。选中某一条后再调 type=line 或 type=line-live。query / line / line-live 的请求和回包不变。地铁会出现在列表里，queryable 为 false。没有命中时 count 为 0，lines 为空数组。
请求参数说明
type（类型）string
必填 · 固定 line-search；也认 line_search / linesearch · 示例：line-search
city（城市）string
必填 · 城市名；认县/市/区/自治州全称 · 示例：长沙
linestring
可选 · 可空=该城可查线路；或路号/线路名，如 1 / 401 / 401路（也认 station） · 示例：1
| 名称 | 类型 | 说明 |
|---|---|---|
| type（类型） | string | 必填 · 固定 line-search；也认 line_search / linesearch · 示例：line-search |
| city（城市） | string | 必填 · 城市名；认县/市/区/自治州全称 · 示例：长沙 |
| line | string | 可选 · 可空=该城可查线路；或路号/线路名，如 1 / 401 / 401路（也认 station） · 示例：1 |
请求头说明
Authorizationstring
可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。
Content-Typestring
必填 · 请求体格式
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
| Content-Type | string | 必填 · 请求体格式 |
返回字段说明
citystring
城市
keywordstring
查询词
countnumber
命中条数；有关键词最多 30，留空最多 80
linesarray
线路列表；有关键词按匹配度，留空按线路名排序
linestring
规范化线路名，可直接传给 type=line / line-live
startstring
起点站
endstring
终点站
first_timestring
首班，没有时为 null
last_timestring
末班，没有时为 null
pricestring
票价，没有时为 null
has_reverseboolean
是否有对向
kindstring
bus 或 subway
queryableboolean
公交为 true；地铁为 false，不能再查全程
tipsstring
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 名称 | 类型 | 说明 | |||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| city | string | 城市 | |||||||||||||||||||||||||||
| keyword | string | 查询词 | |||||||||||||||||||||||||||
| count | number | 命中条数；有关键词最多 30，留空最多 80 | |||||||||||||||||||||||||||
| lines | array | 线路列表；有关键词按匹配度，留空按线路名排序 | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn | |||||||||||||||||||||||||||
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"city": "长沙",
"keyword": "1",
"count": 2,
"lines": [
{
"line": "1路",
"start": "汽车西站",
"end": "长沙火车站",
"first_time": null,
"last_time": null,
"price": null,
"has_reverse": true,
"kind": "bus",
"queryable": true
},
{
"line": "11路",
"start": "汽车西站",
"end": "长沙火车站",
"first_time": null,
"last_time": null,
"price": null,
"has_reverse": true,
"kind": "bus",
"queryable": true
}
]
},
"tips": "极数本源 · https://apizero.cn"
}