ingmapping/docker-mapnik-osm-tiles

docker-mapnik-osm-tiles

从OSM矢量数据生成栅格地图瓦片的容器化项目

概述

本项目是实习作业的一部分，旨在为KNMI地理空间基础设施创建瓦片底图。使用的所有数据和工具均为开源，因此任何想要从免费矢量数据创建简单栅格瓦片底图的用户都可复现该项目。仓库包含在Docker容器内使用Mapnik和generate_tiles.py脚本生成OSM瓦片的所有必要指令和文件。

核心功能

• 从OSM矢量数据生成栅格地图瓦片
• 支持自定义缩放级别（通过MIN_ZOOM和MAX_ZOOM环境变量）
• 与PostGIS容器联动处理地理数据
• 输出标准瓦片目录结构，可直接用于主流地图库

使用场景

• 需要离线或自定义地图瓦片的地理信息系统项目
• 开发基于Leaflet等库的交互式地图应用
• 学习开源地图数据处理和容器化部署

配置说明

1. 部署docker-postgis容器

首先拉取或构建PostGIS镜像：

bash
# 从Docker Hub拉取
docker pull ingmapping/postgis
# 或从源码构建
docker build -t ingmapping/postgis git://github.com/ingmapping/docker-postgis

创建网络以连接两个容器：

bash
docker network create foo

运行PostGIS容器：

bash
docker run --name postgis -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=mysecretpassword -e POSTGRES_DBNAME=gis -p 5432:5432 --net foo -d ingmapping/postgis

（若需启动容器：docker start postgis）

2. 部署docker-mapnik-osm-tiles镜像

构建或拉取镜像：

bash
# 从源码构建
docker build -t ingmapping/docker-mapnik-osm-tiles github.com/ingmapping/docker-mapnik-osm-tiles.git
# 或从Docker Hub拉取
docker pull ingmapping/docker-mapnik-osm-tiles

3. 运行镜像生成瓦片

替换pwd为本地瓦片输出目录，执行：

bash
docker run -i -t --rm --name docker-mapnik-osm-tiles --net foo -v $(pwd)/:/data ingmapping/docker-mapnik-osm-tiles

自定义缩放级别（例如3到14级）：

bash
docker run -i -t --rm --name docker-mapnik-osm-tiles --net foo -v $(pwd)/:/data -e MIN_ZOOM=3 -e MAX_ZOOM=14 ingmapping/docker-mapnik-osm-tiles

4. 解决瓦片权限问题

若容器内root用户生成的瓦片无法本地删除，可通过以下命令清理：

bash
docker run -it --rm -v $(pwd)/:/mnt:z phusion/baseimage bash 
cd mnt 
rm -rf tiles 
exit

5. 使用生成的瓦片

通过Leaflet JS加载瓦片示例：

js
L.tileLayer('file:////本地瓦片目录路径/{z}/{x}/{y}.png', {
	minZoom: 5, maxZoom: 16,
	attribution: '© http://www.openstreetmap.org/copyright contributors | https://github.com/ingmapping/docker-mapnik-osm-tiles/ - ingmapping.com'
}).addTo(map);