Tiler 项目使用教程

1. 项目目录结构及介绍

Tiler 项目的目录结构如下：

tiler/
├── demo/
├── docs/
├── postgis/
├── tiler-data/
│   ├── configs/
│   └── test-data/
├── .gitignore
├── Dockerfile
├── LICENSE.txt
├── README.md
├── circle.yml
├── run.sh
└── tiler.sh

目录介绍

• demo/: 包含项目的演示文件。
• docs/: 包含项目的文档文件。
• postgis/: 包含与 PostGIS 数据库相关的文件。
• tiler-data/: 包含项目的数据文件，包括配置文件和测试数据。
  • configs/: 存放项目的配置文件。
  • test-data/: 存放项目的测试数据。
• .gitignore: Git 忽略文件配置。
• Dockerfile: Docker 构建文件。
• LICENSE.txt: 项目许可证文件。
• README.md: 项目介绍和使用说明。
• circle.yml: CircleCI 配置文件。
• run.sh: 项目启动脚本。
• tiler.sh: 项目主脚本。

2. 项目启动文件介绍

run.sh

run.sh 是 Tiler 项目的主要启动脚本。通过该脚本，用户可以启动项目的不同功能模块。以下是该脚本的基本使用方法：

./run.sh [配置文件名称]

例如，如果有一个名为 states.tiler.json 的配置文件，可以使用以下命令启动项目：

./run.sh states

该脚本会根据配置文件中的设置，生成相应的矢量瓦片文件。

3. 项目的配置文件介绍

tiler-data/configs/ 目录

在 tiler-data/configs/ 目录下，用户可以放置项目的配置文件。配置文件的格式为 JSON，用于指定输入数据、输出目录、简化参数等信息。

以下是一个示例配置文件 states.tiler.json：

{
  "outdir": "/tiler-data/tiles/",
  "tileset": "states",
  "simplification": 5,
  "validate": false,
  "data": {
    "states": {
      "type": "shapefile",
      "databaseInsert": true,
      "paths": ["/tiler-data/test-data/states/states.shp"],
      "minzoom": 0,
      "maxzoom": 5
    },
    "capitals": {
      "type": "postgis",
      "query": "select * from capitals",
      "minzoom": 2,
      "maxzoom": 10
    }
  }
}

配置文件参数说明

• outdir: 输出目录，指定生成的矢量瓦片文件存放的位置。
• tileset: 瓦片集名称，用于标识生成的瓦片集。
• simplification: 简化参数，用于控制瓦片的简化程度。
• validate: 是否进行验证，设置为 true 或 false。
• data: 数据层配置，包含多个数据层的信息。
  • type: 数据类型，可以是 shapefile、geojson、postgis 等。
  • databaseInsert: 是否插入数据库，仅在 type 为 postgis 时有效。
  • paths: 数据文件路径，指定输入数据的文件路径。
  • minzoom: 最小缩放级别。
  • maxzoom: 最大缩放级别。

通过配置文件，用户可以灵活地指定输入数据和输出设置，生成符合需求的矢量瓦片文件。