bvg-route

🚇 柏林实时公交路线智能规划

基于BVG官方API的柏林公共交通规划工具,提供实时准确的地铁、公交、火车换乘方案,助力高效出行。

收藏
4.7k
安装
1k
版本
v0.0.2
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

BVG Route Planner是一款专为柏林地区设计的公共交通路线规划工具,通过集成v6.bvg.transport.rest官方API,为用户提供精准、实时的地铁、公交、火车等公共交通出行方案。该Skill能够智能解析地址、站点名称或地理坐标,支持基于出发时间或到达时间的灵活规划,并返回2-3条优化路线供用户选择。

在核心用法方面,用户只需提供起点和终点信息(支持模糊地址或具体站点名),Skill即可自动完成地理编码和路线计算。系统会生成包含详细分步指引的行程方案,涵盖步行至站点的距离与时间、具体乘坐线路及方向、换乘站点与站台信息,以及预计到达时间。对于需要实时信息的场景,Skill支持获取最近20分钟内的出发时刻表,并提供refreshToken机制用于实时更新行程状态,确保用户掌握最新的延误或调整信息。

该Skill的显著优点在于数据来源的权威性和准确性,直接对接柏林公共交通公司(BVG)的官方API,确保时刻表和路线信息与官方同步。技术实现上,脚本采用set -euo pipefail严格模式,保障了执行的健壮性;通过Python的urllib进行URL编码处理,有效防止了注入攻击;依赖仅使用系统标准工具curl和jq,无额外第三方包引入,降低了供应链风险。

然而,该Skill也存在一定局限性。首先,服务范围严格限定于柏林BVG运营区域,无法处理跨区域或其他城市的路线规划。其次,虽然功能实用,但属于T3级社区来源(个人开发者jaysonsantos),缺乏官方组织背书,且当前使用HTTP协议进行数据传输(虽仅涉及非敏感的公交查询数据)。此外,输入参数的边界验证机制可进一步完善,虽通过-u选项提供了基础保护,但对复杂恶意输入的防御能力有待加强。

目标用户群体主要包括柏林日常通勤者、需要使用公共交通的游客,以及对实时公交信息有高频需求的人群。对于不熟悉柏林复杂交通网络的新居民,该Skill能有效降低出行规划门槛;对于需要精确计算换乘时间的商务人士,其到达时间规划功能尤为实用。

使用过程中的常规风险主要包括:网络依赖风险——必须保持互联网连接才能调用BVG API,离线环境下无法使用;服务可用性风险——API服务器故障或维护将直接影响功能;数据隐私风险——用户输入的起点和终点位置信息需发送至第三方服务器(v6.bvg.transport.rest),虽为匿名查询但仍涉及位置数据外传;以及实时性误差风险——API数据可能存在分钟级延迟,极端情况下与实际车辆到达时间存在偏差,建议用户在关键行程中预留缓冲时间。

安全解读

核心功能

BVG Route Planner 是专为柏林都市圈打造的公共交通路线规划工具,基于 v6.bvg.transport.rest 官方开放 API 构建,提供三大核心能力:

1. 智能路线规划:支持「出发地→目的地」多方案对比,自动计算最快路径、最少换乘、最短步行三种策略,返回 2-3 条可选路线及预计到达时间。
2. 实时到站查询:输入站点名称即可获取最近 20 分钟内 U-Bahn、S-Bahn、公交、电车的实时到站信息,含延误预警。

3. 时间约束规划:支持「最晚到达时间」(arrive-by)和「指定出发时间」(depart-at)两种模式,满足通勤、约会等准时性需求。

显著优点

  • 数据权威性:直连柏林公共交通公司(BVG)官方 API,非第三方爬虫,数据实时性、准确性有保障
  • 覆盖完整:涵盖柏林-勃兰登堡全区域的 U-Bahn、S-Bahn、区域列车、公交、电车、夜间线路
  • 细节丰富:提供站台编号、步行距离/时间、换乘等待时长、线路终点方向等实用信息
  • 零配置使用:无需注册账号或 API Key,开箱即用
  • 刷新机制:支持 journey refreshToken,可持续追踪实时延误变化

局限性与注意事项

  • 地理范围限定:仅支持柏林及周边 VBB 区域,德国其他城市或国际路线无法查询
  • API 依赖风险:v6.bvg.transport.rest 为社区维护的非官方接口(非 BVG 直属),存在服务变更或限流可能
  • 无离线能力:需持续联网,地铁站内信号弱时体验下降
  • 语言局限:API 返回数据主要为德语(站点名、线路名),英文用户需适应
  • 高峰期限流:官方建议速率约 100 req/min,高频调用可能触发限流

适合人群

| 用户类型 | 使用场景 |
|---------|---------|
| 柏林新居民/留学生 | 熟悉线路网络,规划日常通勤 |
| 短期游客 | 查询机场→市区、景点间路线 |
| 准时通勤族 | arrive-by 模式确保不迟到 |
| 夜生活人群 | 查询 Nachtbus 夜间线路时刻 |

常规风险提示

  • 隐私安全:本 Skill 不收集用户位置或行程数据,但 API 调用会暴露 IP 至 v6.bvg.transport.rest 服务器
  • 数据时效:实时数据依赖 BVG 系统更新,极端天气或突发事件时可能存在延迟
  • 站点名称模糊匹配:建议优先使用准确站名(如 "U Alexanderplatz" 而非 "Alex"),或先用 /locations 查询确认 ID

---

技术实现亮点:Skill 采用纯 Markdown 文档(T-MD 分类),无可执行代码,通过标准化的 API 调用规范确保安全性,获 CLS S 级安全认证。

bvg-route 内容

references文件夹
scripts文件夹
手动下载zip · 3.7 kB
API.mdtext/markdown
请选择文件