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 提供的延误时间单位为毫秒