ssubbotin/osmium-tool

Osmium Tool Docker镜像

镜像概述

Osmium Tool Docker镜像是基于Osmium Tool工具的容器化版本，旨在提供便捷的OpenStreetMap (OSM) 数据处理能力。该镜像允许用户无需在本地系统安装复杂依赖，即可直接通过Docker环境执行OSM数据的提取、过滤、转换等操作，适用于地图开发、地理数据处理等场景。

详细使用说明可参考工具官方手册。

核心功能

• 支持处理OSM数据文件（如PBF格式）
• 按边界框（bbox）提取特定地理区域数据
• 按标签（tags）过滤特定类型的地理元素（如建筑物、道路、自然特征等）
• 轻量级容器化设计，简化部署和使用流程

使用场景

• 地图开发者提取特定区域的OSM数据用于应用开发
• 数据分析师过滤和处理OSM数据以获取特定类型地理信息
• 需要快速处理OSM数据但不想配置本地开发环境的用户

使用方法

基本使用前提

使用该镜像时，需将本地数据目录挂载到容器内的/data目录，以便容器访问输入文件并输出处理结果。

示例命令

1. 从全球OSM数据中提取希腊区域数据

bash
docker run -it -v ${PWD}:/data docker.xuanyuan.run/ssubbotin/osmium-tool extract --bbox=17.682871,33.679590,30.404538,42.269466 -o greece.osm.pbf planet-latest.osm.pbf

参数说明：

• -v ${PWD}:/data：将当前工作目录挂载到容器的/data目录
• extract：Osmium Tool的提取命令
• --bbox：指定边界框坐标（格式：min longitude, min latitude, max longitude, max latitude）
• -o greece.osm.pbf：输出文件路径
• planet-latest.osm.pbf：输入的全球OSM数据文件（需位于当前工作目录）

2. 从提取的希腊数据中过滤建筑物、公路和海滩

bash
docker run -it -v ${PWD}:/data docker.xuanyuan.run/ssubbotin/osmium-tool tags-filter -o greece-filtered.osm.pbf greece.osm.pbf building highway natural=beach

参数说明：

• tags-filter：Osmium Tool的标签过滤命令
• building highway natural=beach：指定需保留的标签（分别对应建筑物、公路、自然特征中的海滩）
• -o greece-filtered.osm.pbf：输出过滤后的文件路径
• greece.osm.pbf：输入的希腊区域OSM数据文件（需位于当前工作目录）