terranodo/tegola

Tegola

![Build Status]([] ![Report Card]([] ![Godoc]([***]

镜像概述

Tegola是一款高性能矢量瓦片服务器，以PostGIS为核心数据提供者，输出符合Mapbox Vector Tiles规范的地理数据，支持多种投影与高效几何处理，助力GIS应用快速构建地图服务。

核心功能

• 原生几何处理：支持简化、裁剪、验证、交集等空间操作；
• 规范兼容：严格遵循Mapbox Vector Tile v2标准；
• 嵌入式查看器：自动生成地图样式，快速可视化数据；
• 多源扩展：默认支持PostGIS，可扩展其他数据提供者；
• 缓存机制：本地文件缓存，支持扩展第三方缓存后端；
• 并行处理：瓦片服务与几何计算并行化，提升响应速度；
• 多投影支持：Web Mercator（3857）与WGS84（4326）。

使用场景

• GIS数据可视化：通过内置查看器或第三方库展示空间数据；
• 地图服务搭建：为Web/移动应用提供低延迟矢量瓦片；
• 空间数据分发：高效传递地理信息至客户端；
• 企业GIS集成：支撑内部地理分析与展示需求。

配置说明

采用TOML格式配置文件，典型示例如下：

toml
[webserver]
port = ":9090"  # 服务端口，默认":8080"

[cache]
type = "file"  # 文件缓存类型
basepath = "/tmp/tegola"  # 缓存存储路径

# PostGIS数据提供者配置
[[providers]]
name = "test_postgis"
type = "postgis"
host = "localhost"
port = 5432
database = "tegola"
user = "tegola"
password = ""
srid = 3857
max_connections = "50"

[[providers.layers]]
name = "landuse"
tablename = "gis.zoning_base_3857"
geometry_fieldname = "geom"
id_fieldname = "gid"
srid = 4326

# 地图与图层关联
[[maps]]
name = "zoning"

[[maps.layers]]
provider_layer = "test_postgis.landuse"
min_zoom = 12
max_zoom = 16

[maps.layers.default_tags]
class = "park"

服务器端点

• /：内置查看器，展示自动生成的地图样式；
• /maps/:map_name/:z/:x/:y：返回指定地图的矢量瓦片；
• /maps/:map_name/:layer_name/:z/:x/:y：返回指定图层的矢量瓦片；
• /capabilities：获取服务器配置的地图与图层列表；
• /capabilities/:map_name：获取指定地图的TileJSON详情；
• /capabilities/:map_name/style.json：获取指定地图的Mapbox GL样式。

Docker部署示例

单容器运行

bash
docker run -d \
  -p 9090:9090 \
  -v /本地配置路径/config.toml:/app/config.toml \
  terranodo/tegola \
  -config=/app/config.toml

Docker Compose示例

yaml
version: "3"
services:
  tegola:
    image: terranodo/tegola
    ports: ["9090:9090"]
    volumes: ["./config.toml:/app/config.toml"]
    command: -config=/app/config.toml
    depends_on: [postgis]

  postgis:
    image: postgis/postgis:15-3.3
    environment:
      POSTGRES_USER: tegola
      POSTGRES_PASSWORD: your_pwd
      POSTGRES_DB: tegola
    volumes: [postgis_data:/var/lib/postgresql/data]

volumes:
  postgis_data:

命令行参数

• config：指定配置文件路径（本地/HTTP/HTTPS）；
• port：绑定服务端口（如:8080）；
• log-file：瓦片请求日志路径；
• log-format：日志格式，支持{{.Time}}、{{.RequestIP}}、{{.Z/X/Y}}等字段。

调试方法

环境变量

• SQL_DEBUG=LAYER_SQL：打印图层解析后的SQL；
• SQL_DEBUG=EXECUTE_SQL：打印瓦片请求执行的SQL及结果。

客户端调试

在瓦片URL后加debug=true，可查看瓦片边界与Z/X/Y信息：

http://localhost:9090/maps/mymap/{z}/{x}/{y}.vector.pbf?debug=true

开源许可

遵循MIT协议，详情见https://github.com/terranodo/tegola/blob/master/LICENSE.md%E3%80%82