osrm/osrm-backend

Open Source Routing Machine 镜像文档

镜像概述和主要用途

Open Source Routing Machine（OSRM）是一个基于C++14构建的高性能路由引擎，专为处理OpenStreetMap（OSM）数据设计。本Docker镜像提供OSRM后端服务，可通过HTTP API、C++库接口和Node.js封装提供多种路由功能，适用于构建导航应用、物流规划系统、地理信息服务等场景。

核心功能和特性

主要服务

• Nearest：将坐标点匹配到街道网络并返回最近匹配结果
• Route：查找坐标点之间的最快路径
• Table：计算所有提供坐标点对之间最快路径的持续时间或距离
• Match：将嘈杂的GPS轨迹以最合理的方式匹配到道路网络
• Trip：使用贪心启发式算法解决旅行商问题（TSP）
• Tile：生成包含内部路由元数据的Mapbox矢量瓦片

技术特性

• 基于C++14开发，性能高效
• 支持两种预处理管道：Contraction Hierarchies（CH）和Multi-Level Dijkstra（MLD）
• 提供多种接口（HTTP API、C++库、Node.js绑定）
• 轻量级Docker镜像，基于Debian构建

使用场景和适用范围

• 导航应用后端服务
• 物流配送路径规划
• 地理数据分析与可视化
• 位置服务（LBS）应用开发
• 交通流量分析系统

使用方法和配置说明

前置准备

1. 下载OpenStreetMap数据提取文件（如从http://download.geofabrik.de/获取）

   bash
   wget http://download.geofabrik.de/europe/germany/berlin-latest.osm.pbf
   

Docker镜像使用步骤

1. 数据预处理（MLD管道，推荐）

提取数据

bash
docker run -t -v "${PWD}:/data" docker.xuanyuan.run/osrm/osrm-backend osrm-extract -p /opt/car.lua /data/berlin-latest.osm.pbf

• -v "${PWD}:/data": 将当前工作目录挂载到容器内/data目录
• -p /opt/car.lua: 使用汽车导航配置文件
• 处理后生成berlin-latest.osrm文件

分区处理

bash
docker run -t -v "${PWD}:/data" docker.xuanyuan.run/osrm/osrm-backend osrm-partition /data/berlin-latest.osrm

自定义配置

bash
docker run -t -v "${PWD}:/data" docker.xuanyuan.run/osrm/osrm-backend osrm-customize /data/berlin-latest.osrm

2. 启动路由服务

bash
docker run -t -i -p 5000:5000 -v "${PWD}:/data" docker.xuanyuan.run/osrm/osrm-backend osrm-routed --algorithm mld /data/berlin-latest.osrm

• -p 5000:5000: 将容器5000端口映射到主机5000端口
• --algorithm mld: 使用MLD算法（默认推荐）

3. 测试API请求

bash
curl "http://127.0.0.1:5000/route/v1/driving/13.388860,52.517037;13.385983,52.496891?steps=true"

4. 启动前端界面（可选）

bash
docker run -p 9966:9966 docker.xuanyuan.run/osrm/osrm-frontend
xdg-open 'http://127.0.0.1:9966'  # 在浏览器中打开前端界面

CH管道使用方法（适用于大型距离矩阵）

若需使用CH算法替代MLD，将预处理步骤替换为：

bash
# 替换partition和customize为contract
docker run -t -v "${PWD}:/data" docker.xuanyuan.run/osrm/osrm-backend osrm-contract /data/berlin-latest.osrm

# 启动服务时指定CH算法
docker run -t -i -p 5000:5000 -v "${PWD}:/data" docker.xuanyuan.run/osrm/osrm-backend osrm-routed --algorithm ch /data/berlin-latest.osrm

Docker镜像标签说明

相关资源

• 官方文档：[***]
• HTTP API文档：https://github.com/Project-OSRM/osrm-backend/blob/master/docs/http.md
• 前端镜像：https://hub.docker.com/r/osrm/osrm-frontend/
• Node.js绑定：https://github.com/Project-OSRM/osrm-backend/blob/master/docs/nodejs/api.md

联系与支持

• IRC：irc.oftc.net，频道：#osrm（Webchat）
• 邮件列表：https://lists.openstreetmap.org/listinfo/osrm-talk