柏林公交路线规划

技能简介

本技能基于 v6.bvg.transport.rest API，为柏林地区提供公共交通路线规划服务。支持地址到地址的路线查询、站点实时发车信息、以及指定到达或出发时间的行程规划。

能做什么

• 查询两地之间的公交/地铁/城铁换乘方案（2-3条备选）
• 获取指定站点的下一班车实时信息
• 按”最晚到达时间”或”指定出发时间”规划行程
• 输出每段行程的步行距离、乘车线路、换乘站点及预计耗时
• 提供刷新令牌以获取实时延误更新

使用说明

1. 安装依赖：需配置对 v6.bvg.transport.rest API 的网络访问权限，无需本地安装额外软件包。
2. 解析起止点：调用 /locations 或 /locations/nearby 将地址转换为站点ID（优先使用6位数字IBNR编码，去除 :: 后缀）。
3. 查询路线：调用 /journeys，设置 results=3 和 stopovers=true，根据需求指定 arrival 或 departure 时间参数。
4. 格式化输出：展示总耗时、换乘次数、步行时间及各段详细指引（含站台信息）。
5. 实时更新：保存返回的 refreshToken，通过 /journeys/:ref 获取最新延误状态。
6. 简单查车：对于仅查询发车时间的场景，调用 /stops/:id/departures?duration=20 返回最近3班车。

关键注意事项：

• 所有查询字符串必须URL编码（如空格→%20，ö→%C3%B6）
• IBNR编码仅保留6位数字，去掉前缀和后缀
• 时区默认为 Europe/Berlin

输入与输出

见下方输入与输出表格。

风险提示

• API服务由第三方维护，存在变更或中断可能
• 实时数据依赖BVG系统更新，可能存在延迟
• 地址解析依赖模糊匹配，相似名称可能导致错误站点
• 未处理极端天气或大罢工导致的线路停运情况

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jaysonsantos/bvg-route/SKILL.md
来源类型：GitHub仓库