hsldevcom/digitransit-virtualmonitor

Digitransit Virtual Monitor 镜像文档

1. 镜像概述

Digitransit Virtual Monitor 是 HSLdevcom 开发的公共交通数据监控工具，专注于实时监控和可视化公共交通系统数据。该工具可对接公共交通API，提供车辆实时位置、线路时刻表、系统运行状态等关键信息的可视化展示，帮助用户直观掌握公共交通系统动态。

2. 核心功能与特性

2.1 核心功能

• 实时数据监控：支持接入公共交通实时API，展示车辆实时位置、行驶状态及预计到站时间
• 数据可视化：通过地图、图表等形式直观展示线路覆盖、车辆密度及运行效率
• 系统状态监控：监控API接口可用性、数据更新频率及异常状态报警
• 历史数据回溯：支持查询历史时刻表及车辆运行轨迹，辅助数据分析

2.2 主要特性

• 轻量级部署：基于Docker容器化，支持快速启动和跨平台运行
• 可配置数据源：支持自定义API端点及数据刷新频率
• 多视图展示：提供地图视图、列表视图及统计图表等多种数据呈现方式
• 开源可扩展：基于MIT协议开源，支持二次开发扩展功能

3. 使用场景与适用范围

3.1 适用场景

• 交通管理部门：实时监控公共交通网络运行状态，优化调度策略
• 开发者调试：对接公共交通API时，验证数据格式及接口稳定性
• 公共交通研究：分析车辆运行效率、线路拥堵情况等数据
• 运维监控：监控公共交通数据服务集群的健康状态

3.2 适用范围

• 支持对接符合GTFS（通用公交feed规范）或GBFS（通用自行车共享规范）的公共交通数据接口
• 兼容主流公共交通API服务（如HSL、Transitland等）

4. 使用方法与配置说明

4.1 快速启动（Docker Run）

bash
docker run -d \
  --name digitransit-virtualmonitor \
  -p 8080:8080 \
  -e API_ENDPOINT="https://api.digitransit.fi/routing/v1/routers/hsl/index/graphql" \
  -e REFRESH_INTERVAL=30 \
  hsldevcom/digitransit-virtualmonitor:latest

• -p 8080:8080：映射容器8080端口至主机，通过http://localhost:8080访问监控界面
• -e API_ENDPOINT：公共交通API端点（需替换为实际接口地址）
• -e REFRESH_INTERVAL：数据刷新间隔（单位：秒，默认30）

4.2 Docker Compose 部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  virtualmonitor:
    image: hsldevcom/digitransit-virtualmonitor:latest
    container_name: digitransit-virtualmonitor
    ports:
      - "8080:8080"
    environment:
      - API_ENDPOINT="https://api.digitransit.fi/routing/v1/routers/hsl/index/graphql"
      - REFRESH_INTERVAL=30
      - MAP_TILE_URL="https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png"  # 自定义地图瓦片地址
    restart: unless-stopped

启动命令：

bash
docker-compose up -d

4.3 环境变量配置

4.4 访问与使用

容器启动后，通过浏览器访问 http://<主机IP>:8080 进入监控界面：

• 地图视图：查看实时车辆位置及行驶路线
• 线路列表：筛选特定线路的车辆状态
• 系统监控：查看API响应时间、数据更新状态等系统指标

5. 注意事项

• 需确保目标API端点支持跨域访问或配置代理服务
• 高频率数据刷新可能增加API调用次数，建议根据实际需求调整REFRESH_INTERVAL
• 生产环境建议配置持久化日志存储，便于故障排查

6. 相关资源

• 官方代码库：https://github.com/HSLdevcom/digitransit-virtualmonitor
• API文档：Digitransit Routing API