hsldevcom/opentripplanner-data-server

OpenTripPlanner数据服务镜像

镜像概述

OpenTripPlanner数据服务镜像是一款轻量级Docker镜像，专为部署和提供OpenTripPlanner（OTP）出行规划引擎所需的基础数据而设计。该镜像基于高效服务架构，可稳定提供地理空间数据（如OSM地图）和交通数据（如GTFS公共交通信息），支持OTP引擎实现多模式（公共交通、步行、自行车等）出行规划功能。

核心功能和特性

• 数据服务能力：提供OTP引擎运行所需的基础数据访问接口，支持数据查询、缓存与动态加载。
• 兼容性：适配OpenTripPlanner 2.x及以上版本，确保与主流OTP引擎无缝集成。
• 轻量级设计：基于精简基础镜像构建，资源占用低，支持在服务器、边缘设备及容器编排平台（K8s、Docker Swarm）部署。
• 灵活配置：支持通过环境变量和数据挂载自定义数据路径、服务端口及日志级别，适应不同场景需求。
• 数据更新支持：支持外部数据目录挂载，无需重建镜像即可更新地理或交通数据。

使用场景和适用范围

• 出行规划应用后端：为基于OTP的出行规划APP、导航系统提供数据支撑。
• 交通数据分析平台：作为交通数据服务节点，为交通流量分析、出行行为研究提供标准化数据接口。
• 智慧城市项目：集成到智慧城市平台，支持交通管理、公共服务优化等场景。
• 开发与测试环境：为OTP应用开发人员提供本地数据服务，简化开发与测试流程。

使用方法和配置说明

基本部署（Docker Run）

通过以下命令启动镜像，挂载本地数据目录并映射服务端口：

bash
docker run -d \
  --name otp-data-service \
  -p 8080:8080 \
  -v /path/to/local/otp-data:/data \
  -e DATA_PATH=/data \
  -e PORT=8080 \
  docker.xuanyuan.run/opentripplanner/data-service:latest

参数说明：

• -v /path/to/local/otp-data:/data：挂载本地OTP数据目录（需包含OSM、GTFS等数据文件）到容器内/data路径。
• -e DATA_PATH=/data：指定容器内数据存储路径（需与挂载路径一致）。
• -e PORT=8080：设置服务监听端口，默认8080。

环境变量配置

数据准备与挂载

1. 数据文件要求：本地数据目录需包含以下文件（格式需符合OTP规范）：

   • OSM地图数据（.osm.pbf格式）
   • GTFS公共交通数据（.zip格式）
   • 可选：地形数据（.tif格式）、网络配置文件（router-config.json）

2. 数据更新：替换本地挂载目录中的数据文件后，重启容器即可应用更新：

   bash
   docker restart otp-data-service
   

容器编排示例（Docker Compose）

创建docker-compose.yml文件，实现与OTP引擎联动部署：

yaml
version: '3'
services:
  otp-data:
    image: docker.xuanyuan.run/opentripplanner/data-service:latest
    container_name: otp-data-service
    ports:
      - "8080:8080"
    volumes:
      - ./otp-data:/data  # 本地OTP数据目录
    environment:
      - DATA_PATH=/data
      - PORT=8080
      - LOG_LEVEL=INFO
    restart: unless-stopped

  otp-engine:
    image: docker.xuanyuan.run/opentripplanner/otp:latest
    container_name: otp-engine
    ports:
      - "8081:8080"
    environment:
      - ROUTER_NAME=default
      - DATA_SERVICE_URL=http://otp-data:8080  # 连接数据服务
    depends_on:
      - otp-data
    restart: unless-stopped

启动命令：docker-compose up -d

注意事项

• 数据文件需通过OTP官方工具预处理（如otp --build），确保格式兼容。
• 大规模数据部署建议配置足够内存（≥4GB）及存储IO性能，避免服务延迟。
• 生产环境建议配合反向代理（如Nginx）使用，增强安全性与负载能力。