swiss-transport

🚆 瑞士官方实时交通查询助手

基于瑞士官方开放数据平台 transport.opendata.ch,提供火车、公交、电车、渡轮实时时刻表查询与路线规划,无需 API 密钥即可获取精准公共交通信息。

收藏
4.1k
安装
1.6k
版本
v1.0.0
CLS 安全性认证2026-05-17
点击查看完整报告 >

使用说明

核心用法

Swiss Public Transport 是一款专注于瑞士公共交通信息查询的实用技能,通过调用瑞士官方开放数据平台 transport.opendata.ch 的 API,为用户提供全面的出行信息服务。该技能支持四大核心功能:车站搜索(locations)、出发时刻表查询(stationboard)、A到B路线规划(connections)以及详细的换乘信息展示。用户可通过简单的自然语言交互,如"苏黎世下一班火车几点出发"或"如何从伯尔尼到日内瓦",快速获取实时交通数据。

技能提供了丰富的查询参数支持,包括按交通工具类型筛选(高铁、城际列车、区域列车、公交、电车、渡轮等)、指定日期时间、设置中转次数限制等。配套的 Python 辅助脚本 journey.py 进一步简化了命令行使用体验,支持格式化输出和自定义结果数量。

显著优点

官方数据源保障准确性:直接对接瑞士联邦铁路(SBB)等官方机构的实时数据,包含延误信息、站台变更等动态更新,数据可靠性远超第三方聚合平台。

零门槛使用体验:无需注册账号、申请 API 密钥或支付费用,完全开放的公共数据接口降低了使用门槛,个人开发者和普通用户均可即时调用。

多模态交通整合:覆盖瑞士全境的火车(SBB、BLS 等)、公交(ZVV 等)、电车、渡轮等多种交通方式,支持跨运营商的无缝路线规划。

轻量高效的技术实现:仅依赖 Python 标准库,无第三方包依赖,部署简单;10 秒超时设置和 URL 编码处理确保了请求的稳定性与安全性。

潜在缺点与局限性

地理范围受限:服务仅限瑞士境内,无法查询跨国路线(如瑞士到法国、德国的国际段),跨境出行需配合其他工具使用。

功能深度有限:仅提供时刻表查询和基础路线规划,不支持在线购票、座位预订、票价计算(部分信息需跳转官方渠道)等增值服务。

实时性依赖网络:作为在线 API 查询工具,无网络环境或官方服务故障时将完全不可用,缺乏离线缓存机制。

结果数量上限:单次查询最多返回 16 条路线方案,复杂场景下的多方案对比可能受限。

适合的目标群体

  • 瑞士本地居民与通勤者:日常上下班、上学的固定路线查询与延误监控
  • 赴瑞游客与商务人士:行程规划、车站导航、实时出发信息获取
  • 开发者与数据分析师:基于官方交通数据构建衍生应用或进行出行模式研究
  • 多语言助手集成场景:需要为瑞士用户提供本地化交通查询服务的 AI 应用

使用风险

网络稳定性风险:API 服务由瑞士官方维护,虽可靠性较高,但仍可能因维护或流量高峰出现短暂不可用,建议关键出行预留备用查询方案。

数据时效性边界:实时延误信息更新存在分钟级延迟,极端天气或突发运营调整时,建议以车站现场公告为准。

时区处理注意:所有时间均为瑞士本地时间(CET/CEST),跨国用户需注意与本地时间的换算,避免误读出发时间。

无持久化存储:技能本身不保存查询历史或偏好设置,频繁重复查询相同路线时需重新输入参数。

安全解读

核心用法

Swiss Transport 是一款专为瑞士公共交通设计的查询工具,基于瑞士联邦交通局官方开放数据 API(transport.opendata.ch)。主要功能包括:

  • 站点搜索:通过 /v1/locations 接口模糊搜索车站、地址或POI
  • 实时时刻表:通过 /v1/stationboard 获取指定站点的即将出发列车/公交信息
  • 路线规划:通过 /v1/connections 查询两地之间的最优换乘方案
  • 行程详情:获取完整行程的各段信息,包括出发/到达时间、换乘次数、交通工具类型

支持多种交通方式过滤(ICE/TGV、城际列车、区域列车、公交、电车、渡轮等),时间参数支持ISO格式,自动处理夏令时转换。

显著优点

1. 官方数据源:直接对接瑞士联邦交通局API,数据权威、更新及时,包含实时延误和站台变更信息
2. 零配置使用:无需注册账号或API密钥,开箱即用,降低使用门槛

3. 覆盖全面:整合SBB、BLS、ZVV等瑞士主要运营商数据,一张网络覆盖全国

4. 轻量无依赖:核心功能仅使用Python标准库,无第三方依赖,部署简单安全

5. 开放生态:基于开放数据原则,支持学术研究和第三方应用开发

潜在缺点与局限性

1. 地域限制:仅覆盖瑞士境内及跨境线路的瑞士段,不支持其他国家独立查询
2. 语言局限:API返回数据以德语、法语、意大利语为主,英语支持有限

3. 功能边界:不提供票价查询、座位预订、延误赔偿等增值服务

4. 离线不可用:完全依赖网络连接,无离线时刻表缓存机制

5. 输入容错:站点名称虽支持自动补全,但对拼写错误容错性一般

适合人群

  • 瑞士本地居民日常通勤查询
  • 赴瑞游客行程规划
  • 交通数据研究者与开发者
  • 需要集成瑞士交通数据的第三方应用

常规风险

  • 公共服务API存在速率限制,高频调用可能被临时限制
  • 实时数据偶有延迟,极端天气或突发事件时建议交叉验证
  • 输入验证和错误处理有待完善,异常输入可能导致请求失败

swiss-transport 内容

scripts文件夹
手动下载zip · 3.2 kB
journey.pytext/plain
请选择文件