MOTIS实时交通数据解析完整指南:GTFS-RT与SIRI如何驱动延误、取消与轨道变更

原创2026-11-15 21:08:011,426 阅读

MOTIS实时交通数据解析完整指南:GTFS-RT与SIRI如何驱动延误、取消与轨道变更

MOTIS 是一款开源的多模态交通路由引擎,提供公交/铁路路径规划、地理编码与地图瓦片服务。其核心亮点之一是实时交通数据解析:通过接入 GTFS-RT 与 SIRI 协议源,MOTIS 能持续把列车/班车的延误、取消、停运与轨道(站台)变更同步进内存中的实时时刻表(rt timetable),让路由结果永远基于"当下"而非静态计划。🚄

MOTIS 实时交通地图元素图标集(GTFS-RT 与 SIRI 数据驱动的交通状态展示素材)

MOTIS 支持哪几种实时数据协议?

在配置文件 include/motis/config.h 中定义了 4 种实时协议,每个数据源(dataset)都可挂载一个或多个实时端点(url + 可选 headers + protocol):

协议 配置值 说明
GTFS-RT gtfsrt 默认协议,Google 定义的实时格式(protobuf),覆盖延误与取消
SIRI Lite(XML) siri 欧洲标准 SIRI,目前支持 ET、FM、SX 三个服务
SIRI Lite(JSON) siri_json 同 siri,但期望 JSON 结构的响应
VDV AUS / VDV454 auser 德国 VDV 标准,需要 auser 组件处理订阅

协议支持细节可参考官方文档 docs/setup.md。

一键配置:在数据源下挂载 rt 端点

只需在 timetable.datasets 下为某个 tag 添加 rt 列表即可,一个数据源可接多个实时流(例如延误流 + 取消流分开提供时):

timetable:
  datasets:
    ch:
      path: swiss_fedtrans.gtfs.zip
      rt:
        - url: https://api.opentransportdata.swiss/gtfsrt2020
          protocol: gtfsrt

完整示例见 docs/setup.md。注意 siri_json 协议要求响应顶层直接是 ResponseTimestamp 等字段,若多包了一层 Siri/ServiceDelivery 会解析失败。

GTFS-RT 如何解析延误与取消

MOTIS 的更新循环在 src/rt_update.cc:按 update_interval 周期性对所有端点发起 HTTP 请求,并发拉取,解析后合并进一张全新的 rt_timetable,再通过 std::atomic_store 原子替换全局实时数据——查询线程全程无锁读,互不阻塞。

GTFS-RT 的 TripUpdate 被解析为 nigiri 的 frun(实时班次)结构,携带三类关键状态:

  • 延误:每个站点的预计到达/出发时间相对计划时间的差值(delay);
  • 取消:班次整体标记 CANCELED,站点级标记 SKIPPED(该站不停车);
  • 无数据:站点标记 NO_DATA,表示该点尚无实时信息。

这套状态随后被路由引擎直接消费:被取消的班次不再出现在规划结果中,延误则用于比较候选连接的实际到达时间。取消班次的识别逻辑(对比计划交通日与实时交通日)可见 src/endpoints/gtfsrt.cc。

SIRI:从预计时间到轨道变更

SIRI Lite 是欧洲(CEN SIRI)的实时标准,MOTIS 支持三个服务:

  • ET(Estimated Timetable):预计时刻表。EstimatedVehicleJourney 中每个 EstimatedCall 的 ExpectedArrivalTime / ExpectedDepartureTime 与 Aimed* 对比即得延误;
  • FM(Facility Monitoring):设施监测,例如电梯是否可用;
  • SX(Situation Exchange):事件通告。

SIRI 还带来 GTFS-RT 不具备的能力——轨道(站台)变更。EstimatedCall 中的 DeparturePlatformName / ArrivalPlatformName 会被解析进实时时刻表,使 /map/trips 等接口返回实时轨道而非 GTFS 里的静态 platform_code。单元测试 test/endpoints/rt_track_test.cc 完整演示了:GTFS 中不带轨道信息、轨道仅来自 SIRI 实时更新(E / 2 / 22)的场景。

德国 VDV AUS 协议(auser)的增量订阅与 XML 解析在 src/rt/auser.cc 实现:首次拉取 auser/fetch?since=...,之后凭消息中的 auser_id 做增量更新。

实时数据如何驱动前端与下游系统

  • 路由与地图:实时时刻表同步生成 railviz_rt_index(见 include/motis/railviz.h),使 RailViz 地图按实时轨道绘制列车路线;
  • 对外再发布:MOTIS 自身也提供 GTFS-RT 端点,把聚合后的实时状态(延误 + 取消 + 新增班次)序列化为 protobuf 重新发布,受配置项 gtfsrt_expose_max_trip_updates 限制规模,实现见 src/endpoints/gtfsrt.cc;
  • 监控指标:每个端点的拉取次数、成功/失败次数与更新时间戳都以 Prometheus 指标暴露(如 nigiri_gtfsrt_updates_successful_total),定义在 include/motis/rt/rt_metrics.h,方便接入 /metrics 监控;
  • 调试友好:创建 dump_rt/ 目录可录制每次拉取的原始响应,配合 canned_rt 配置可离线重放实时流,便于测试(src/rt_update.cc)。

实时无障碍路由:SIRI FM 驱动的电梯状态

SIRI FM 数据还有一个特殊用途:更新车站电梯的可用状态。每次实时更新时,src/elevators/update_elevators.cc 会对比新旧电梯状态,对发生变更的电梯,重新计算其周边位置点对之间的无障碍步行路径——轮椅用户的路由结果也随之实时更新。

小结

MOTIS 的实时链路可以概括为:配置端点 → 周期并发拉取 → 解析为实时时刻表 → 原子热替换 → 驱动路由/地图/再发布。GTFS-RT 负责通用的延误与取消,SIRI(ET/FM/SX)补充预计时刻、轨道变更与设施状态,VDV AUS 覆盖德国场景。理解了这条数据流,你就能让 MOTIS 在真实运营场景中输出"实时且可靠"的路由结果。✅

登录后查看全文
motis