heigit/osm-transform

osm-transform

代码地址：https://github.com/GIScience/osm-transform/

镜像概述

本镜像封装了osm-transform命令行工具，用于预处理OpenStreetMap（OSM）数据以适配路由场景。工具通过过滤无关路由的数据（如建筑物）、富集国家归属信息及可选的高程数据，生成体积更小的优化PBF文件，可直接用于openrouteservice的图构建。

核心功能

1. 过滤OSM PBF文件中与路由无关的数据（如建筑物、POI等）
2. 为数据添加国家归属信息
3. 可选添加高程数据（通过GeoTIFF文件）
4. 输出优化后的PBF文件，支持openrouteservice等路由服务

使用场景

• openrouteservice图构建前的数据预处理
• OSM数据轻量化处理，减少存储和计算资源消耗
• 路由相关OSM数据的快速过滤与富集

配置说明

工具支持通过命令行参数配置，核心参数包括：

• -i：输入OSM PBF文件路径
• -o：输出优化后的PBF文件路径
• -c：国家边界索引文件路径
• -e：高程GeoTIFF文件路径（支持通配符）
• -vvv：详细日志输出

Docker部署示例

构建镜像

shell
docker rmi local/osm-transform:latest # 清理旧镜像（可选）
docker build -t local/osm-transform:latest .

使用预构建镜像

直接使用Docker Hub上的预构建镜像：heigit/osm-transform:latest

运行镜像

获取帮助：

shell
docker run --rm docker.xuanyuan.run/heigit/osm-transform:latest -h

处理数据（挂载本地目录到容器）：

shell
docker run --rm \
    -v ~/data/osm:/app/osm \
    -v ~/data/countries:/app/countries \
    -v ~/data/elevation:/app/elevation \
    -v .:/app/out \
    docker.xuanyuan.run/heigit/osm-transform:latest \
    -i /app/osm/heidelberg.test.pbf \
    -o /app/out/heidelberg.ot.pbf \
    -c /app/countries/world_borders_idx_0_40 \
    -e '/app/elevation/*/*.tif' \
    -vvv

本地运行与构建（参考）

运行测试

shell
cargo test

集成测试：

shell
cargo test --test integration_test

本地运行

shell
cargo clean && cargo run -- <参数>

获取帮助：

shell
cargo run -- -h

本地构建

shell
cargo clean && cargo build # 调试版本
cargo clean && cargo build --release # 优化版本

可执行文件位于target/debug或target/release目录下。

shell
./target/debug/osm-transform <参数>
./target/release/osm-transform <参数>

roadmap

• 性能与内存占用优化
• 支持自定义过滤规则
• 扩展更多富集数据源（如时区CSV、其他栅格数据）
• 支持仅构建区域索引而不处理PBF文件