使用tippecanoe 进行矢量地图切片，切片格式由geojson转为pbf

1. 安装

  • 需求Linux环境
  • 需要 sqlite3, zlib两个库文件

1.1 安装库文件支持

  1. #安装make
  2. sudo apt-get install build-essential libsqlite3-dev zlib1g-dev

1.2 安装tippecanoe

  1. #下载
  2. wget https://github.com/mapbox/tippecanoe/archive/1.34.3.tar.gz
  4. #解压
  5. tar -zxvf 1.34.3.tar.gz
  7. #编译及安装
  8. cd tippecanoe-1.34.3/
  9. make
  10. make install

或

  1. #下载
  2. git clone https://github.com/mapbox/tippecanoe.git
  4. #编译及安装
  5. cd tippecanoe
  6. make && make install

1.3 验证是否安装成功

  1. tippecanoe -v

2. 一般数据生产使用

  1. tippecanoe -e [文件夹名称] -z [最大缩放等级] -Z [最小缩放等级] -pC XX.geojson
  1. tippecanoe -e test -s EPSG:3857 -z 20 -Z 18  -pC polygon.geojson
  2. //批处理
  3. for i in `ls`;do tippecanoe -e ${i%_*} -s EPSG:3857 -z 20 -Z 18  -pC $i;done

将polygon.geojson文件进行矢量切片，传入的坐标系为3857，切片等级12-18，切片生成的目录名称为test,不使用geobuf压缩

2.1 Geojson数据转换成mbtiles数据（测试通过）

接下来就是进行矢量瓦片的生成部分, Tippecanoe为用户提供了多种切片配置参数,如缩放级别、要素简化程度、筛选要素等，也可以选择输出mbtiles矢量瓦片数据集或pbf矢量瓦片文件两种格式，详细的参数说明可以参考说明https://github.com/mapbox/tippecanoe/blob/master/README.md。

  1. # 80M=>17M
  2. tippecanoe -z14 -pS -g3 -r1.25 -o jianzhuwu.mbtiles jianzhuwu.geojson
  3. #切片到目录
  4. tippecanoe -z14 -pS -g3 -r1.25 -e jianzhuwu jianzhuwu.json
  1. tippecanoe -z14 -pS -g3 -r1.25 -s EPSG:3857 -o jianzhuwu.mbtiles jianzhuwu.geojson

其中各参数的配置参考上述链接,这里不予赘述。有一点值得注意的是,如果在上文数据源shp的投影设置为EPSG:4326,这里就可以不通过-s命令进行投影设置,因为默认采用的就是EPSG:4326;而如果上文采用EPSG:3857,这里就需要进行-s EPSG:3857进行投影设置。(注意:矢量切片配置参数的搭配要按照项目的实际需求进行不同的设置!) 在完成上述命令后,可以在对应的文件夹中看到yourData.mbtiles矢量瓦片数据集,如果是linux系统,直接可以通过sqlite3进行查看。

  1. # 80M=>7M
  2. tippecanoe -zg -pS -o jianzhuwu.mbtiles jianzhuwu.geojson
  1. tippecanoe -zg -pS -e 0104 jianzhuwu.geojson

切成按zoom级别分割的文件夹

注意：source-layer填如入参的geojson文件名

  1. sources: {
  2.   jianzhuwu: {
  3.     type: 'vector',
  4.     tiles: [
  5.       'http://127.0.0.1:8085/1/2/3/915e6641-a14c-4222-a658-be0eb995a852/{z}/{x}/{y}.pbf'
  6.     ],
  7.   }
  8. },
  9. layers: [{
  10.   "id": "jianzhuwu",
  11.   "type": "fill",
  12.   "source": "jianzhuwu",
  13.   "source-layer": "23de09937f324c5e8c0c49eeecf95734",
  14.   "paint": {
  15.     "fill-translate-anchor": "map",
  16.     "fill-color": "rgba(8, 179, 225, 1)"
  17.   }
  18. }]

3. 常用选项

通常情况，我们需要将geojson文件转换为geobuf。

使用方法为：

  1. tippecanoe -o file.mbtiles [options] [file.json file.geobuf ...]

3.1 输出格式

  • -o file.mbtiles or --output=file.mbtiles：输出mbtiles文件
  • -e directory or --output-to-directory=directory：输出文件至指定 目录
  • -f or --force：如果mbtiles文件已存在，则删除它
  • -F or --allow-existing：如果已经存在对应的文件，不删除已存在的文件

3.2 切片描述与水印

  • -n name or —name=name: （默认）生成XXX.json作为可读的切片描述
  • -A text or —attribution=text: 切片水印
  • -N description or —description=description: 生成XXX.mbtiles作为切片描述

3.3 输入文件和图层名称

  • name.json or name.geojson: 将geojson的 name 写入图层名称，命名为 name
  • name.geobuf or name.geobuf: 将geobuf的 name 写入图层名称，命名为 name
  • -l name or —layer=name: 使用指定的名称而不是输入文件名称作为图层名称
  • -L name:file.json or —named-layer=name:file.json: 对每一个文件指定图层名称

3.4 输入文件的投影

  • -s projection or —projection=projection: 指定输入文件的坐标系 EPSG:4326 (默认WGS84) and EPSG:3857 (Web Mercator). 通常情况下，使用WGS84作为输入文件的坐标系

3.5 缩放等级

  • -z zoom or —maximum-zoom=zoom: 最大缩放等级
  • -zg or —maximum-zoom=g: 默认使用估算合理的最大缩放等级
  • -Z zoom or —minimum-zoom=zoom: 最小缩放等级
  • -ae or —extend-zooms-if-still-dropping: 如果最小要素依然存在，增大最大的缩放等级

3.6 切片分辨率

  • -d detail or —full-detail=detail: 最大缩放等级的分辨率(默认 12级, 切片分比率 2^12=4096)
  • -D detail or —low-detail=detail: 较低等级的分辨率(默认 12级, 切片分比率 2^12=4096)
  • -m detail or —minimum-detail=detail: 最小的分辨率（默认7级）

3.7 属性表过滤器

  • -x name or —exclude=name: 移除所有要素对应的指定字段
  • -y name or —include=name: 移除所有空字段要素
  • -X or —exclude-all: 移除所有属性字段，只保留几何字段
  • -T attribute:type or —attribute-type=attribute:type: 改变指定字段的类别：string, float, int, bool.
  • -j filter or —feature-filter=filter: 字段过滤，”*”表示使用所有图层，使用mapbox过滤函数
  • -J filter-file or —feature-filter-file=filter-file: 和”-j”一样，只不过从文件中过滤

字段过滤example:

  1. tippecanoe -z 5 -o filtered.mbtiles -j '{ "ne_10m_admin_0_countries": [ "all", [ "<", "scalerank", 3 ], [ ">", "LABELRANK", 5 ] ] }' ne_10m_admin_0_countries.geojson

3.8 线、面的简化

  • -S scale or —simplification=scale: 容差
  • -ps or —no-line-simplification: 无线简化
  • -pS or —simplify-only-low-zooms: 在高缩放等级时不简化
  • -pt or —no-tiny-polygon-reduction: 不合并面

3.9 公共面边界优化

  • -ab or —detect-shared-borders: 检测公共边界并简化
  • -aL or —grid-low-zooms: 线、面吸附

3.10 裁剪切片边界

  • -b pixels or —buffer=pixels: 缓冲区（默认5，2^5=32）
  • -pc or —no-clipping: 不裁剪
  • -pD or —no-duplication: 无重复

3.11 切片要素重排

  • -pi or —preserve-input-order: 以输入顺序作为绘制顺序
  • -ao or —reorder: 所有同属性要素按顺序重排
  • -ac or —coalesce: 合并具有相同属性的相邻线、面
  • -ar or —reverse: 合并相邻但反向的线段

3.12 增加计算的额外字段

  • -ag or —calculate-feature-density: 增加字段tippecanoe_feature_density, 用于描述切片中的要素密度

3.13 修复破损几何

  • -aw or —detect-longitude-wraparound: 检测相邻点，并修复几何

3.14 切片大小设

  • -M bytes or —maximum-tile-bytes=bytes: 切片大小指定（默认500k）
  • -pf or —no-feature-limit: 切片要素数量限制（默认20W）
  • -pk or —no-tile-size-limit: 不使用切片大小限制
  • -pC or —no-tile-compression: 不使用PBF压缩（此处必须选择，否则mapbox无法使用）
  • -pg or —no-tile-stats: 不生成切片信息

3.15 临时储存

  • -t directory or —temporary-directory=directory: 临时目录，如果未指定，使用/tmp.

3.16 结果指示器

  • -q or —quiet: 静默模式
  • -v or —version: 返回Tippecanoe版本号