osmandapp/osmand-mapcreator

OsmAndMapCreator Docker镜像

概述

本Docker镜像封装了OsmAndMapCreator工具，旨在提供便捷的容器化部署方式，帮助用户快速创建适用于OsmAnd应用的离线地图。OsmAndMapCreator是一款用于处理OpenStreetMap (OSM) 数据并生成OsmAnd兼容地图文件的工具，通过Docker化部署，可避免本地环境配置复杂依赖的问题，实现跨平台一致运行。

核心功能与特性

• 容器化部署：无需在本地安装Java、地图处理依赖库等，直接通过Docker容器运行，简化环境配置。
• 地图生成：支持处理OSM原始数据，生成OsmAnd应用可识别的地图文件（.obf格式）。
• 跨平台兼容：可在任何支持Docker的操作系统（如Linux、Windows、macOS）上运行。
• 数据隔离：通过挂载本地目录实现输入数据（OSM文件）和输出结果（地图文件）的持久化存储。

使用场景与适用范围

• OsmAnd用户：需要为特定区域创建自定义离线地图的个人用户。
• 开发者：集成到地图生成流程中，自动化处理OSM数据并生成地图文件。
• 户外活动爱好者：为偏远地区或无网络环境准备离线地图。
• 企业/组织：需要批量生成特定区域地图供内部使用的场景。

使用方法与配置说明

前提条件

• 已安装Docker Engine（版本20.10+）。
• 准备好待处理的OSM数据文件（如.osm或.pbf格式）。

基本使用命令

bash
docker run -v /path/to/local/osm/data:/input \
           -v /path/to/output/maps:/output \
           docker.xuanyuan.run/osmandmapcreator:latest \
           --input /input/your_data.osm.pbf \
           --output /output/

参数说明

• -v /path/to/local/osm/data:/input：挂载本地OSM数据目录到容器内/input路径，用于读取输入数据。
• -v /path/to/output/maps:/output：挂载本地输出目录到容器内/output路径，用于保存生成的地图文件。
• --input /input/your_data.osm.pbf：指定容器内输入数据的路径（需与挂载的/input目录对应）。
• --output /output/：指定容器内输出目录（需与挂载的/output目录对应）。

高级配置（可选）

可通过环境变量调整地图生成参数，例如：

• MAX_MEMORY：设置JVM最大内存（默认：2G），如-e MAX_MEMORY=4G。
• REGION_NAME：指定生成地图的区域名称，如-e REGION_NAME="MyCustomRegion"。

示例：

bash
docker run -v /local/osm:/input \
           -v /local/maps:/output \
           -e MAX_MEMORY=4G \
           -e REGION_NAME="Alps" \
           docker.xuanyuan.run/osmandmapcreator:latest \
           --input /input/alps.osm.pbf \
           --output /output/

输出说明

生成的地图文件（.obf）将保存在本地挂载的/path/to/output/maps目录中，可直接导入OsmAnd应用使用。

注意事项

• 处理大型OSM数据文件时，建议增加容器内存分配（通过MAX_MEMORY环境变量）。
• 确保输入的OSM数据文件格式正确（推荐使用.pbf格式以提高处理效率）。
• 首次运行可能需要下载基础地图处理依赖，耗时取决于网络环境。