protomaps/go-pmtiles

go-pmtiles Docker镜像文档

镜像概述和主要用途

本Docker镜像是https://github.com/protomaps/go-pmtiles%E9%A1%B9%E7%9B%AE%E7%9A%84Docker Hub镜像。go-pmtiles是一个轻量级工具，专门用于处理PMTiles档案——一种高效存储和传输地图瓦片的开放数据格式。该镜像提供容器化部署方式，核心用途是创建、读取PMTiles档案及通过HTTP服务提供档案中的地图瓦片。

核心功能和特性

• 全生命周期管理：支持PMTiles档案的完整处理流程，包括创建（从原始瓦片数据生成）、读取（解析元数据与内容）和服务（HTTP瓦片分发）。
• 单一二进制架构：工具以独立可执行文件形式构建，容器化后消除依赖管理复杂性，部署便捷。
• 轻量级设计：基于精简基础镜像构建，镜像体积小，运行时资源占用低，适合边缘环境和资源受限场景。
• 跨平台一致性：通过Docker容器确保在Linux、macOS、Windows等不同操作系统中行为一致。

使用场景和适用范围

• 地图服务开发：快速构建自定义地图瓦片服务，适用于Web地图、移动应用等场景。
• 离线地图应用：为野外作业、无网络环境提供本地地图瓦片访问能力。
• 数据格式转换：将MBTiles等传统瓦片格式转换为PMTiles，优化存储效率和传输性能。
• CI/CD集成：在地图数据 pipeline 中自动化处理瓦片档案生成与验证。

使用方法和配置说明

基础使用流程

通过docker run命令启动容器，指定go-pmtiles命令及参数。需通过目录挂载实现主机与容器间的PMTiles文件交互。

常用命令示例

1. 查看工具帮助

bash
docker run --rm protomaps/go-pmtiles --help

2. 查看PMTiles档案信息

获取档案元数据（边界、层级范围、瓦片数量等）：

bash
docker run --rm -v /local/path/to/pmtiles:/data protomaps/go-pmtiles info /data/archive.pmtiles

3. 创建PMTiles档案

从瓦片目录生成PMTiles（假设/local/tiles包含Z/X/Y结构的瓦片文件）：

bash
docker run --rm -v /local/tiles:/input -v /local/output:/output protomaps/go-pmtiles create /input /output/new_archive.pmtiles

4. 启动HTTP瓦片服务

将PMTiles档案作为HTTP服务暴露（映射容器8080端口到主机）：

bash
docker run --rm -p 8080:8080 -v /local/pmtiles:/data protomaps/go-pmtiles serve /data/archive.pmtiles --port 8080

服务启动后，可通过http://localhost:8080/{z}/{x}/{y}.mvt访问对应层级的地图瓦片（具体格式取决于档案内容）。

关键配置参数

核心命令及常用参数说明：

数据持久化配置

通过目录挂载实现文件持久化：

bash
-v /host/path/to/pmtiles:/data  # 将主机PMTiles目录映射到容器/data目录

容器内所有文件操作建议使用/data作为工作目录，确保数据持久化到主机。