hsldevcom/raildigitraffic2gtfsrt

芬兰交通局开放数据转GTFS-realtime镜像

镜像概述

该Docker镜像专注于将芬兰交通局（Finnish Transport Agency）开放数据API提供的公共交通实时数据转换为GTFS-realtime标准格式。GTFS-realtime是公共交通领域广泛使用的实时数据交换标准，可被各类出行应用、交通管理系统等直接解析和应用。

核心功能

• 数据转换：自动将芬兰交通局API返回的原始数据转换为符合GTFS-realtime规范的Protocol Buffers格式
• API对接：内置与芬兰交通局开放数据API的通信逻辑，支持身份验证和数据请求
• 实时处理：支持定时或事件触发式数据获取与转换，保障信息时效性
• 标准化输出：生成的GTFS-realtime数据兼容主流解析工具和应用平台

适用场景

• 公共交通应用开发者集成芬兰地区实时公交/轨道交通信息
• 交通数据分析师获取标准化的实时交通数据进行分析
• 城市交通管理部门构建实时交通监控系统
• 出行服务平台提供准确的芬兰公共交通实时到站信息

使用方法

基本使用（Docker Run）

bash
docker run -d \
  -e API_KEY="your_finnish_transport_api_key" \
  -e FETCH_INTERVAL=5 \
  -v /host/path/to/output:/app/output \
  --name finnish-gtfs-rt-converter \
  finnish-transport-gtfs-rt:latest

Docker Compose配置

yaml
version: '3'
services:
  gtfs-rt-converter:
    image: finnish-transport-gtfs-rt:latest
    environment:
      - API_KEY=your_finnish_transport_api_key
      - FETCH_INTERVAL=5
      - LOG_LEVEL=info
    volumes:
      - ./output:/app/output
    restart: unless-stopped

配置参数说明

环境变量

数据输出

转换后的GTFS-realtime数据以.pb文件格式存储在指定的OUTPUT_PATH路径下，包含以下实体信息：

• 车辆位置（VehiclePositions）
• 行程更新（TripUpdates）
• 服务告警（ServiceAlerts）

注意事项

• 需提前向芬兰交通局申请开放数据API访问权限以获取API_KEY
• 建议根据实际需求调整FETCH_INTERVAL，避免过于频繁的API请求
• 生产环境中建议通过卷挂载（volume）持久化输出数据，防止容器重启后数据丢失