使用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
  3. #解压
  4. tar -zxvf 1.34.3.tar.gz
  5. #编译及安装
  6. cd tippecanoe-1.34.3/
  7. make
  8. make install

  1. #下载
  2. git clone https://github.com/mapbox/tippecanoe.git
  3. #编译及安装
  4. cd tippecanoe
  5. 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版本号