Mvg_知识管理 skill-PHP中文网

Mvg

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

慕尼黑公共交通（MVG）命令行工具及S-Bahn实时追踪。用于查询发车时间、路线规划、附近站点、服务提醒及S-Bahn实时位置。

MVG CLI.

功能概述

MVG CLI.是一项面向实际任务的技能，主要用于Munich 公交自終站.. 使用非官方的MVG API(bgw-pt/v3)-不需要认证.；Setup.；

核心要点

CLI : python3 <skill dir>/mvg cli.py. 依赖性:Python 3, urlib(stdlib o)。
它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。

使用与执行

从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

MVG CLI

通过终端访问慕尼黑公共交通信息。使用非官方 MVG API（bgw-pt/v3），无需身份验证。

安装与配置

CLI 启动方式：python3 /mvg_cli.py
依赖项：Python 3，仅需标准库 urllib
S-Bahn 实时追踪：需安装 node 及 ws 模块以支持 WebSocket 连接

命令列表

# 车站搜索
mvg search "Marienplatz"

# 班次信息（出发时间）
mvg departures "Marienplatz"
mvg departures "Marienplatz" --type ubahn --limit 20
mvg departures "Daglfing" --offset 5          # 预估步行 +5 分钟

# 路线规划（支持车站名或地址）
mvg route "Marienplatz" "Garching"
mvg route "Hauptstr. 1, München" "Flughafen"  # 支持地址解析
mvg route "Pasing" "Ostbahnhof" --time "08:30" --mode less-changes

# 周边车站
mvg nearby                                     # 使用默认经纬度坐标
mvg nearby 48.1351 11.5820

# 运营公告（服务提醒）
mvg alerts
mvg alerts --station "Marienplatz"

# 线路查询
mvg lines --type sbahn

# S-Bahn 实时追踪（基于 geOps WebSocket 的实时数据）
mvg live                                       # 所有 S-Bahn 线路
mvg live --line S3                             # 指定线路

所有命令均支持 --json 参数，输出机器可读的 JSON 格式结果。

交通方式筛选器

可在 --type 或 --exclude 中使用以下类型标识符：ubahn、sbahn、bus、tram、bahn（含 RE/RB）、regionalbus、ruftaxi

路线规划选项

--mode：可选 fast（默认）、less-changes、less-walking
--walk-speed：可选 slow、normal（默认）、fast
--accessible：仅返回无障碍通行路线（轮椅友好）
--via "Station"：指定途经中间站点
--arrive：将 --time 解释为到达时间（而非出发时间）

API 相关说明

基础 URL：https://www.mvg.de/api/bgw-pt/v3/
可用端点：/locations、/departures、/routes、/stations/nearby、/lines、/messages
路线响应中的到达时间：请使用 to.plannedDeparture 字段（而非 plannedArrival）
S-Bahn 实时数据：通过 wss://api.geops.io/realtime-ws/v1/ 的 WebSocket 获取，需发送 GET sbm_full、SUB sbm_full 及 BBOX 消息
geOps 提供的延误时间单位为毫秒