skanetrafiken

🚂 瑞典南部实时公交火车规划

基于 Skånetrafiken 官方 API 的瑞典斯科讷省公共交通规划工具,支持实时延误查询与跨境哥本哈根行程,为通勤者提供精准的公交火车换乘方案。

收藏
5.1k
安装
2.1k
版本
v1.2.0
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

核心用法

Skanetrafiken Trip Planner 是一款面向瑞典斯科讷省(Skåne)地区的公共交通行程规划工具,通过调用 Skånetrafiken 官方 API 实现实时公交、火车信息查询。该技能包含两个核心脚本::search-location.sh 用于搜索站点、地址或地标的位置 ID,,journey.sh 用于规划两点之间的完整行程。用户可通过自然语言时间表达(如"in 30 minutes"、"arrive by 18:00")触发查询,系统会自动解析时间意图并转换为 API 参数。特别支持跨境行程规划至丹麦哥本哈根,覆盖 Pågatåg 区域列车、Öresundståg 跨境列车、巴士及哥本哈根地铁等多种交通方式。

显著优点

精准的时间意图解析:技能内置完善的自然语言时间处理机制,能识别"now"、"around 15:00"、"tomorrow morning"等 6 类时间意图,并自动计算偏移量展示前后选项。对于"around time"类查询,系统会智能提前 15-30 分钟查询,确保用户看到目标时段前后的完整选择。

专业的响应格式化:提供详细的 LLM 输出规范,包含 17 个标准化 emoji 用于区分交通类型(🚂火车、🚌巴士、🚇地铁)、状态(✅准点、⚠️延误)及行程节点(🔄换乘、🛤️站台)。强制要求展示步行段距离与时间,确保用户掌握完整的门到门时间规划。

鲁棒的输入处理:针对 API 的特性差异,技能明确了不同位置类型的查询格式——地标仅用名称、地址需加城市名、火车站使用官方"C"后缀。对于 ADDRESS 和 POI 类型结果,自动转换为坐标格式适配 Journey API,避免调用失败。

完善的错误处理:脚本采用 set -euo pipefail 严格模式,设置 30 秒 curl 超时,临时文件使用 PID 隔离并配置 trap 自动清理。API 响应经 JSON 格式验证后才进入解析流程,错误信息输出至 stderr 不影响正常解析。

潜在缺点与局限性

地域限制明显:仅覆盖瑞典斯科讷省及哥本哈根跨境区域,对瑞典其他地区(如斯德哥尔摩、哥德堡)或国际其他城市无支持。API 数据源单一,若 Skånetrafiken 服务中断则完全不可用。

依赖系统工具:硬性依赖 curl 和 jq,虽为常见工具但在精简容器或特定企业环境中可能缺失。无内置依赖检查与自动安装机制,需用户自行确保环境就绪。

T3 来源维护风险:作者为个人开发者(rezkam),非官方交通机构或成熟组织。长期维护稳定性、功能更新响应速度存在不确定性,不适合作为生产环境关键业务依赖。

网络依赖性强:所有功能均需实时连接 Skånetrafiken 官方服务器,无离线缓存或历史数据查询能力。网络波动时用户体验显著下降。

适合的目标群体

  • 斯科讷省居民与通勤者:日常依赖公共交通往返马尔默、隆德、赫尔辛堡等地的上班族与学生
  • 跨境旅客:频繁往返瑞典与丹麦哥本哈根之间的商务人士与游客
  • AI 助手开发者:需要为瑞典南部地区用户提供交通查询能力的 Claude Code 或其他兼容 Agent 的开发者
  • 临时访客:前往斯科讷省旅游、需要实时公交火车信息规划行程的国际游客

使用风险

性能风险:API 响应时间受网络状况与官方服务器负载影响,高峰期可能出现延迟。curl 30 秒超时设置虽防止无限等待,但在弱网环境下可能导致查询失败。

数据准确性风险:实时延误信息依赖 Skånetrafiken 数据更新频率,极端天气或突发事故时信息可能存在滞后。用户应预留缓冲时间,不宜将查询结果作为唯一决策依据。

API 变更风险:非官方维护的第三方封装,若 Skånetrafiken 调整 API 端点或响应格式,现有脚本可能失效,需等待作者更新或自行修复。

隐私合规风险:查询数据发送至瑞典官方服务器,虽仅包含位置信息无个人身份数据,但跨境数据传输需符合用户所在地区数据保护法规要求。

安全解读

Skånetrafiken 公共交通规划器 — 综合评估

核心用法

Skånetrafiken 是一款专为瑞典斯科讷省(Skåne)及周边地区设计的公共交通查询工具,完整覆盖巴士、通勤火车(Pågatåg)、厄勒海峡列车(Öresundståg)、哥本哈根地铁等多元交通方式。用户可通过自然语言查询实现:

  • 智能地点搜索:支持车站(STOP_AREA)、地址(ADDRESS)、地标/POI 三类定位,针对 POI 和地标建议仅使用名称(如 "Emporia"),地址则需附加城市名(如 "Storgatan 12, Malmö")
  • 灵活时间规划:内置"立即出发""约X点出发""X点前抵达"等多种时间意图解析,自动处理相对时间计算(如"半小时后")与跨天查询
  • 实时行程规划:返回含步行段、换乘等待、站台信息、延误状态的完整方案,支持 Malmö↔Lund、Malmö↔哥本哈根等跨境路线

显著优点

1. 实时数据权威:直连 Skånetrafiken 官方 API,延误信息秒级同步,瑞典南部通勤者刚需工具
2. LLM 友好设计:提供详细的 emoji 响应格式指南(🚂火车/🚌巴士/🚶步行等),降低 AI 解析与呈现门槛

3. 类型系统完善:自动处理 STOP_AREA → LOCATION 的类型转换(地址/地标转坐标),API 调用容错性强

4. 零第三方依赖:仅需系统标配 curl/jq,无 Node/Python 生态依赖,部署极简

潜在局限

1. 地理范围受限:核心服务区域为斯科讷省,哥德堡、斯德哥尔摩等省外查询需转用其他工具
2. 时间语法瑞典本地化:自然语言时间解析依赖瑞典语环境("imorgon 09:00"),非瑞典语用户可能困惑

3. 无票务功能:仅规划行程,购票需跳转 Skånetrafiken 官方 App 或车站机器

4. 离线不可用:完全依赖网络 API,地下车站等弱网场景体验受限

适合人群

  • 斯科讷省居民与通勤者(Malmö、Lund、Helsingborg 等)
  • 频繁往返哥本哈根-马尔默的跨境通勤者
  • 瑞典南部商务差旅与留学生群体
  • 需要集成公共交通查询的本地化 AI 应用

常规风险

  • API 可用性:官方服务维护或限流时可能暂时失效(建议按文档添加指数退避重试)
  • 地址歧义:同名街道在不同城市存在时需显式标注城市名
  • 时区感知:行程时间默认为瑞典本地时间(CET/CEST),跨国用户需注意与哥本哈根时区一致但需确认夏令时

skanetrafiken 内容

手动下载zip · 12.8 kB
journey.shtext/x-shellscript
请选择文件