mschilde/osmium-tool

Osmium Tool Docker镜像

该镜像包含osmium-tool (v1.14.0)，基于osmium库 (v2.18.0)构建。

详细使用信息请参阅工具手册。

源代码可在https://github.com/mschilde/docker-osmium-tool%E8%8E%B7%E5%8F%96%E3%80%82

镜像概述和主要用途

Osmium Tool Docker镜像是一个预配置的环境，用于运行osmium-tool——一款高效处理OpenStreetMap (OSM)数据的命令行工具。OSM数据通常以PBF（ProtocolBuffer Binary Format）等格式存储，该工具支持对这些数据进行提取、过滤、转换、合并等多种操作，适用于需要处理大规模OSM数据的场景。

核心功能和特性

• 基于osmium-tool v1.14.0和osmium库v2.18.0，确保功能稳定性和兼容性
• 支持按边界框（bbox）提取特定区域的OSM数据
• 支持按标签（tags）过滤OSM元素（如建筑、公路、自然特征等）
• 高效处理PBF格式数据，适合大规模OSM数据集（如planet-latest.osm.pbf）
• 无需本地安装依赖，通过Docker容器即可快速使用

使用场景和适用范围

• OSM数据开发者：需要提取特定区域或过滤特定要素的数据处理
• 研究人员：分析OSM数据中的地理特征（如道路网络、建筑分布）
• 地图服务提供者：预处理OSM数据以构建自定义地图

使用方法和配置说明

基本使用方式

通过docker run命令运行容器，需挂载本地工作目录（用于数据输入输出），并指定osmium-tool命令及参数。

参数说明

• -it：交互式终端（可选，用于需要交互的场景）
• -w /wkd：设置容器内工作目录为/wkd
• -v $(pwd):/wkd：将本地当前目录挂载到容器内的/wkd目录，实现数据共享

示例1：从全球OSM数据中提取希腊区域

bash
docker run -it -w /wkd -v $(pwd):/wkd mschilde/osmium-tool osmium extract --bbox=17.682871,33.679590,30.404538,42.269466 -o greece.osm.pbf planet-latest.osm.pbf

说明：

• osmium extract：提取命令
• --bbox=17.682871,33.679590,30.404538,42.269466：希腊区域的边界框坐标（格式：min经度,min纬度,max经度,max纬度）
• -o greece.osm.pbf：输出文件
• planet-latest.osm.pbf：输入文件（全球OSM数据，需预先下载到本地当前目录）

示例2：从提取的区域数据中过滤特定要素

bash
docker run -w /wkd -v $(pwd):/wkd mschilde/osmium-tool osmium tags-filter -o greece-filtered.osm.pbf greece.osm.pbf building highway natural=beach

说明：

• osmium tags-filter：标签过滤命令
• -o greece-filtered.osm.pbf：输出文件
• greece.osm.pbf：输入文件（示例1中提取的希腊区域数据）
• building highway natural=beach：过滤条件，保留包含building标签、highway标签或natural=beach标签的OSM元素