damirda/osmium-tool

osmium-tool-dk Docker镜像

镜像概述

osmium-tool-dk是osmium-tool的Docker镜像，基于https://hub.docker.com/_/debian%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%9B%86%E6%88%90%E4%BA%86osmium-tool%E5%B7%A5%E5%85%B7%E3%80%82osmium-tool%E6%98%AF%E4%B8%80%E6%AC%BE%E5%9F%BA%E4%BA%8EOsmium%E5%BA%93%E7%9A%84%E5%91%BD%E4%BB%A4%E8%A1%8C%E5%B7%A5%E5%85%B7%EF%BC%8C%E4%B8%93%E4%B8%BA%E5%A4%84%E7%90%86OpenStreetMap (OSM) 数据设计，提供高效的数据操作能力。

核心功能和特性

• 多用途数据处理：支持OSM数据的创建、读取、修改、转换和分析
• 高效性能：基于Osmium库，针对大规模OSM数据优化，处理速度快
• 轻量级基础：使用debian:stable-slim作为基础镜像，镜像体积小，资源占用低
• 完整工具集：包含osmium-tool的全部命令，如数据过滤、提取、合并、裁剪等

使用场景

• OpenStreetMap数据的批量处理和转换
• 从OSM数据中提取特定区域或要素（如道路、建筑）
• OSM数据格式转换（如OSM XML与PBF格式互转）
• 地图数据预处理和分析
• 自动化OSM数据处理流程集成

使用方法

基本使用

通过docker run命令运行osmium-tool，需挂载本地目录以实现数据输入输出：

bash
docker run --rm -v $(pwd):/data osmium-tool-dk osmium [command] [options]

常用命令示例

1. 查看帮助信息：

   bash
   docker run --rm osmium-tool-dk osmium --help
   

2. 将OSM XML文件转换为PBF格式：

   bash
   docker run --rm -v $(pwd):/data osmium-tool-dk osmium cat -O -o /data/output.osm.pbf /data/input.osm
   

3. 提取特定区域数据：

   bash
   docker run --rm -v $(pwd):/data osmium-tool-dk osmium extract -b 13.0,52.0,14.0,53.0 -o /data/berlin.osm.pbf /data/germany.osm.pbf
   

Docker Compose配置（可选）

对于复杂的数据处理流程，可使用docker-compose.yml简化操作：

yaml
version: '3'
services:
  osmium:
    image: osmium-tool-dk
    volumes:
      - ./data:/data
    command: osmium cat -O -o /data/output.osm.pbf /data/input.osm

运行：

bash
docker-compose up

配置说明

osmium-tool的配置主要通过命令行参数实现，具体参数可参考官方文档。常用参数包括：

• -O, --overwrite：覆盖已存在的输出文件
• -o, --output：指定输出文件路径
• -b, --bbox：指定边界框（用于提取区域数据）
• --progress：显示处理进度

镜像本身无额外环境变量配置，所有功能通过osmium-tool命令行参数控制。