pchynoweth/osmium-tool

Osmium Tool Docker镜像

镜像概述

本镜像为Osmium Tool的容器化版本。Osmium Tool是一款用于处理OpenStreetMap (OSM) 数据的命令行工具，支持数据提取、过滤、转换等多种操作。通过Docker镜像，用户可快速部署并使用该工具，无需手动配置依赖环境。

详细使用说明请参考工具手册。

核心功能

• 数据提取：根据边界框（bbox）等条件从大型OSM数据文件中提取特定区域数据
• 标签过滤：基于标签（tags）筛选OSM元素（如建筑物、道路、自然特征等）
• 容器化优势：无需安装依赖，直接通过Docker命令运行，环境一致性高

使用场景

• OSM数据处理与分析
• 提取特定区域的地图数据
• 筛选特定类型的OSM元素（如建筑物、道路网络等）
• 地图数据预处理与转换

使用方法

基本使用步骤

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

目录挂载说明

使用-v $(pwd):/wkd将当前目录挂载到容器内的/wkd目录，-w /wkd设置工作目录为/wkd，确保容器内可访问本地OSM文件并输出结果到本地。

示例命令

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

bash
docker run -it -w /wkd -v $(pwd):/wkd pchynoweth/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：希腊区域的边界框坐标（格式：min经度,min纬度,max经度,max纬度）
• -o greece.osm.pbf：输出文件路径
• planet-latest.osm.pbf：输入的全球OSM数据文件（需位于当前目录）

示例2：过滤提取数据中的建筑物、高速公路和海滩

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

参数说明：

• tags-filter：标签过滤命令
• building highway natural=beach：筛选条件（建筑物、高速公路、自然特征为海滩）
• -o greece-filtered.osm.pbf：输出过滤后的文件
• greece.osm.pbf：输入的希腊区域OSM数据文件（需为示例1的输出文件）