hsldevcom/siri2gtfsrt

siri2gtfsrt Docker 镜像文档

镜像概述

siri2gtfsrt 镜像提供了一个轻量级工具，专门用于将 SIRI（Service Interface for Real Time Information）格式的公共交通实时数据转换为 GTFS-realtime 格式。GTFS-realtime 是公共交通领域广泛采用的实时数据交换标准，该镜像旨在解决不同数据格式间的互操作性问题，方便实时交通数据的集成与应用。

核心功能与特性

• 格式转换：支持将 SIRI 格式（包括 SIRI-VM、SIRI-SX 等子规范）的数据转换为符合 GTFS-realtime 规范的 Protocol Buffers 格式。
• 数据验证：内置数据校验机制，确保转换后的 GTFS-realtime 数据符合规范要求。
• 轻量级部署：基于精简基础镜像构建，容器体积小，资源占用低，适合在各类环境中快速部署。
• 灵活配置：支持通过环境变量或配置文件自定义转换规则，适配不同数据源的 SIRI 数据结构。

使用场景

• 公交运营监控：将公交公司提供的 SIRI 实时数据转换为 GTFS-realtime 格式，供运营监控系统接入。
• 公共交通信息平台：为交通信息平台（如出行 App、电子站牌）提供标准化的 GTFS-realtime 数据。
• 第三方应用集成：帮助开发者快速对接采用 SIRI 格式的数据源，降低实时交通数据接入门槛。

使用方法

基本运行命令

通过以下命令启动容器，实现 SIRI 到 GTFS-realtime 的转换：

bash
docker run -d \
  --name siri2gtfsrt \
  -e SIRI_INPUT_URL="http://example.com/siri-feed" \  # SIRI 数据源 URL
  -e GTFSRT_OUTPUT_PATH="/data/output.pb" \          # GTFS-realtime 输出文件路径
  -v /local/data:/data \                             # 挂载本地目录用于数据持久化
  siri2gtfsrt:latest

环境变量配置

Docker Compose 配置示例

创建 docker-compose.yml 文件，配置如下：

yaml
version: '3'
services:
  siri2gtfsrt:
    image: siri2gtfsrt:latest
    container_name: siri2gtfsrt
    restart: always
    environment:
      - SIRI_INPUT_URL=http://transit-api.example.com/siri/vm
      - GTFSRT_OUTPUT_PATH=/data/gtfs-rt.pb
      - POLL_INTERVAL=30
      - LOG_LEVEL=INFO
    volumes:
      - ./local-data:/data  # 本地目录挂载，用于存储输出的 GTFS-realtime 文件
    ports:
      - "8080:8080"  # 可选：暴露 HTTP 接口（如提供转换状态查询）

启动服务：

bash
docker-compose up -d

数据输出与集成

转换后的 GTFS-realtime 数据默认保存至容器内的 GTFSRT_OUTPUT_PATH 路径。通过挂载本地目录（如示例中的 /local/data），可在宿主机上获取输出文件，供后续应用（如 GTFS-realtime 服务器、出行 App 后端）直接使用。