klokantech/tileserver-mapnik

tileserver-mapnik

镜像概述和主要用途

tileserver-mapnik是一个基于Mapnik的瓦片服务器，能够从tilelive-js源（如MapBox Studio项目、自定义矢量瓦片等）生成栅格瓦片，并支持静态地图API。该镜像提供了便捷的地图瓦片服务解决方案，适用于需要快速部署地图瓦片服务的场景。

核心功能和特性

• 基于Mapnik引擎生成高质量栅格瓦片
• 支持多种tilelive-js数据源，包括MapBox Studio项目（.tm2）和MBTiles文件
• 提供静态地图生成API，支持中心坐标和区域范围两种模式
• 支持HiDPI（retina）瓦片渲染（通过@2x参数）
• 提供TileJSON接口，便于客户端集成
• 可配置缓存大小，优化瓦片服务性能

使用场景和适用范围

• Web地图应用后端瓦片服务
• 自定义地图样式展示与瓦片生成
• GIS系统中的地图瓦片服务
• 需要从矢量瓦片或MapBox Studio项目生成栅格瓦片的场景
• 开发和测试环境中的地图服务快速部署

使用方法和配置说明

Docker方式

运行tileserver-mapnik最简单的方式是使用预编译的Docker容器（https://hub.docker.com/r/klokantech/tileserver-mapnik/%EF%BC%89%E3%80%82

详细使用说明请参考：[***]

非Docker方式

按照Dockerfile中的命令安装必要的软件包、下载常用字体并准备环境。

使用命令：node bin/tessera.js [options]

可用选项

• -c CONFIG - 配置文件路径
• -p PORT - HTTP服务端口，默认值：8080
• -C SIZE - 缓存大小（MB），默认值：10
• -S SIZE - 源缓存大小（源数量），默认值：10

配置文件示例

javascript
{
  "/style1": {
    "source": "tmstyle://./style1.tm2"
  },
  "/style2": {
    "source": "tmstyle:///home/user/style2.tm2"
  },
  "/vector": {
    "source": "mbtiles:///home/user/data.mbtiles"
  }
}

注意：对于tm2样式，需确保样式的project.yml文件中的source属性指向有效的MBTiles文件（例如：source: "mbtiles://./data.mbtiles"）。

可用URL

• 访问配置的端口（默认8080）可在浏览器中查看地图
• 瓦片服务URL格式：/{basename}/{z}/{x}/{y}[@2x].{format}
  • 可选的@2x部分用于渲染HiDPI（retina）瓦片
• 静态图片渲染URL：
  • 基于中心坐标：/{basename}/static/{lon},{lat},{zoom}/{width}x{height}[@2x].{format}
  • 基于区域范围：/{basename}/static/{minx},{miny},{maxx},{maxy}/{zoom}[@2x].{format}
• TileJSON接口：/{basename}/index.json