vireak/osrm-backend

柬埔寨路线数据服务Docker镜像

镜像概述

本Docker镜像专注于提供柬埔寨地区的路线数据服务，核心功能为支持禁用金边附近渡轮道路的路线规划与管理，适用于需要精准区域路线控制的应用场景。

核心功能与特性

• 区域路线数据支持：内置柬埔寨全境路线网络数据，包含道路属性、通行规则等基础信息
• 金边渡轮道路禁用：专门针对金边附近渡轮道路设置禁用规则，确保路线规划中自动排除相关路段
• 轻量级部署：基于Docker容器化设计，资源占用低，部署流程简化，支持快速集成
• 数据可配置：允许通过环境变量或配置文件调整禁用规则范围及路线优先级

使用场景与适用范围

• 导航应用开发：为柬埔寨本地导航类应用提供排除金边渡轮道路的精准路线数据
• 物流路径规划：辅助物流企业优化运输路线，避开金边附近渡轮道路以提升效率
• 地图服务集成：作为第三方地图服务的补充数据源，增强特定区域路线控制能力
• 交通管理系统：支持交通管理部门对金边周边道路通行规则进行数字化管理

使用方法与配置说明

快速启动

通过以下命令启动容器，默认启用金边渡轮道路禁用功能：

bash
docker run -d -p 8080:8080 --name cambodia-route-service cambodia-route:latest

环境变量配置

可通过环境变量调整服务参数，常用配置如下：

示例：指定自定义端口及数据刷新间隔

bash
docker run -d -p 9000:9000 \
  -e SERVICE_PORT=9000 \
  -e DATA_REFRESH_INTERVAL=720 \
  --name cambodia-route-service cambodia-route:latest

数据持久化

如需持久化存储路线数据及配置文件，可挂载本地目录至容器内/app/data路径：

bash
docker run -d -p 8080:8080 \
  -v /host/path/to/data:/app/data \
  --name cambodia-route-service cambodia-route:latest

接口调用示例

服务启动后，可通过HTTP接口获取路线数据，以下为获取金边至暹粒禁用渡轮道路的路线示例：

bash
curl "http://localhost:8080/routes?origin=phnom-penh&destination=siem-reap&disableFerry=true"

响应示例（JSON格式）：

json
{
  "routeId": "CAM-20240510-001",
  "origin": "phnom-penh",
  "destination": "siem-reap",
  "distance": 314000,
  "duration": ***,
  "segments": [...],
  "disabledFerryRoads": ["FR-PP-001", "FR-PP-003"]
}