morlov/tippecanoe

Tippecanoe Alpine Linux镜像

镜像概述和主要用途

该镜像基于Alpine Linux构建，集成了Mapbox开发的Tippecanoe工具，用于将地理空间数据（如JSON、GeoBuf等格式）转换为MBTiles瓦片集。镜像体积小巧（<13Mb），提供完整的Tippecanoe工具链，支持交互与非交互两种使用模式，适用于地图瓦片生成、地理数据处理等场景。

核心功能和特性

• 轻量级设计：镜像体积小于13Mb，资源占用低，部署高效
• 完整工具集：包含tippecanoe及其相关工具（tile-join、tippecanoe-decode等）
• 灵活使用模式：支持交互模式（进入容器环境操作）和非交互模式（直接执行命令）
• 跨平台兼容：可在任何支持Docker的环境中运行

使用场景和适用范围

• 地理数据格式转换（JSON/GeoBuf → MBTiles）
• 地图瓦片集生成与优化
• 批量地理数据处理自动化
• 地图应用开发中的瓦片数据准备

使用方法和配置说明

交互模式

通过挂载本地目录到容器，进入交互式环境执行Tippecanoe命令：

bash
docker run -it -v $HOME/tippecanoe:/tippecanoe morlov/tippecanoe:latest
/ # tippecanoe -o file.mbtiles [options] [file.json file.json.gz file.geobuf ...]

非交互模式

直接指定入口命令，在容器外部执行Tippecanoe操作：

bash
docker run --entrypoint tippecanoe -v $HOME/tippecanoe:/tippecanoe morlov/tippecanoe:latest -o file.mbtiles [options] [file.json ...]

包含的工具集

镜像内置完整的Tippecanoe工具链：

• /usr/bin/tile-join
• /usr/bin/tippecanoe
• /usr/bin/tippecanoe-decode
• /usr/bin/tippecanoe-json-tool
• /usr/bin/tippecanoe-enumerate

Tippecanoe核心配置选项

输出瓦片集

• --output=output.mbtiles：指定输出MBTiles文件路径
• --output-to-directory=...：输出到目录而非MBTiles文件
• --force：覆盖已存在的输出文件
• --allow-existing：允许输出文件已存在

瓦片集元数据

• --name=...：设置瓦片集名称
• --attribution=...：设置数据归属信息
• --description=...：设置瓦片集描述

输入与图层配置

• --layer=...：指定默认图层名称
• --named-layer=...：为特定文件指定图层名称
• --read-parallel：并行读取输入文件

缩放级别控制

• --maximum-zoom=...：设置最大缩放级别（默认14）
• --minimum-zoom=...：设置最小缩放级别（默认0）
• --extend-zooms-if-still-dropping：若要素仍被丢弃则自动扩展缩放级别
• --one-tile=...：生成单个瓦片（指定缩放级别）

瓦片优化参数

• --simplification=...：设置几何简化程度（默认2）
• --buffer=...：设置瓦片边界缓冲像素数（默认5）
• --drop-densest-as-needed：根据瓦片大小限制自动丢弃密集要素
• --coalesce-densest-as-needed：根据瓦片大小限制自动合并密集要素

参考链接

• 项目地址：https://github.com/MiklerGM/mbtiles/
• 官方文档：https://github.com/mapbox/tippecanoe