stefda/osmium-tool

Osmium工具Docker镜像

镜像概述

Osmium工具Docker镜像是封装了Osmium Tool的容器化解决方案。Osmium Tool是一款功能强大的命令行工具，专门用于处理和操作OpenStreetMap (OSM) 数据，支持数据提取、过滤、转换、合并等多种操作。通过Docker镜像，用户可以快速部署和使用Osmium Tool，无需手动配置依赖环境。

核心功能与特性

• 数据提取：支持通过边界框（bbox）等方式从大型OSM数据文件（如planet-latest.osm.pbf）中提取特定区域的数据
• 标签过滤：根据地理要素标签（如building、highway、natural=beach等）筛选OSM数据
• 容器化部署：无需安装复杂依赖，通过Docker即可快速运行
• 灵活的文件挂载：支持将本地目录挂载到容器中，方便数据输入输出

使用场景

• 从全球OSM数据中提取特定国家或地区的数据
• 筛选OSM数据中的特定地理要素（如建筑物、道路、自然景观等）
• 预处理OSM数据用于地图制作、地理信息分析等应用

使用方法与配置说明

基本使用步骤

1. 确保本地已安装Docker
2. 通过docker run命令运行镜像，指定工作目录和数据挂载
3. 执行Osmium Tool命令进行数据处理

常用参数说明

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

示例

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

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

说明：

• --bbox=17.682871,33.679590,30.404538,42.269466：指定希腊区域的边界框坐标（经度最小值,纬度最小值,经度最大值,纬度最大值）
• -o greece.osm.pbf：输出提取后的数据到本地当前目录的greece.osm.pbf文件
• planet-latest.osm.pbf：输入的全球OSM数据文件（需确保该文件在本地当前目录）

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

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

说明：

• tags-filter：根据标签筛选数据
• building highway natural=beach：筛选包含building标签、highway标签或natural=beach标签的地理要素
• -o greece-filtered.osm.pbf：输出过滤后的数据到本地当前目录的greece-filtered.osm.pbf文件
• greece.osm.pbf：输入的希腊区域OSM数据文件（需确保该文件在本地当前目录）

更多使用信息

详细使用方法请参考Osmium Tool官方手册