常用tippecanoe参数设置

 

     Tippecanoe 用于将 GeoJSON, Geobuf, 或者 CSV 格式的矢量要素转换为矢量瓦片。Tippecanoe 的目的是将数据制作为比例独立的视图，以使在任何缩放级别下，都可以看到数据的密度和细节，而不是将数据简化或聚合。

 

1、输出选项

-o file.mbtiles   或   --output=file.mbtiles           指定输出mbtiles文件的文件名

-e directory      或    --output-to-directory=directory      指定输出文件的路径

-f 或–force           若存在同名文件则删除，不抛出错误

-F 或 --allow-existing         忽略元数据或瓦片已存在的情况，一般不推荐使用

 

2、瓦片集属性选项

-n name 或 --name=name           给瓦片集设置一个易读的名字

-A text 或--attribution=text        瓦片集在地图上显示的属性

-N description 或--description=description       瓦片集描述

 

3、输入文件和图层名

      name.json     或   name.geojson         读取GeoJSON文件

name.json.gz   或   name.geojson.gz     读取GeoJSON压缩文件

name.geobuf        读取Geobuf文件

name.csv              读取CSV文件

-l name  或 --layer=name    使用自定义图层名，而不是默认的输入文件名作为图层名。如果有多个输入文件，输入文件将被合并为一个图层，除非使用-L选项来分别指定图层名

-L name:file.json   或 --named-layer=name:file.json    定义每个输入文件对应的图层名

例：tippecanoe -z5 -o world.mbtiles -L'{"file":"ne_10m_admin_0_countries.json", "layer":"countries", "description":"Natural Earth countries"}'

-L{layer-json}   或 --named-layer={layer-json}     通过 json对象定义图层

 

4、坐标系

-s  projection   或 --projection=projection       给定输入文件的坐标系统。当前支持的坐标系有EPSG:4326（WGS84，默认值）、EPSG:3857（Web Mercator）。请尽量使用WGS84坐标系统的数据集。

 

5、切片级别

-z zoom  或  --maximum-zoom=zoom     切片的最大级别（默认为14）

-zg      或 --maximum-zoom=g                根据数据的密集程度自动计算一个最大级别

-Z zoom    或 --minimum-zoom=zoom      切片的最小级别（默认0）

-ae  或   --extend-zooms-if-still-dropping     如果在大级别下瓦片仍然很大，它将自动增加最大级别，以使最大级别下没有要素被删除

--drop-densest-as-needed                     如果在小级别下瓦片太大，该选项将自动简化要素

--extend-zooms-if-still-dropping        如果在大级别下瓦片仍然很大，它将自动增加最大级别，以使最大级别下没有要素被删除

--coalesce-densest-as-needed        如果瓦片在低级别或中等级别下比较大，该选项将合并要素；

 

6、属性筛选

-x name    或 --exclude=name          指定切片中应剔除的字段。

-y name  或 --include=name         指定切片中应包含的字段。

-X        或  --exclude-all             剔除所有字段，仅仅编码“geometry”字段

-T attribute:type    或     --attribute-type=attribute:type         强制将要素的 attribute属性类型转换为指定的type类型。

type的取值范围：string，float，int，或bool。如果是bool，那么原始属性中的0，false，null、或者空字符串都会被转为false，其它都被转为true。如果是float或int并且原始数据为非数字，则会被转为0。如果是int并且原始数据为浮点型，将会被转为与其最接近的整数。

 

7、瓦片分辨率

-d detail   或 --full-detail=detail          在最大级别时的“详细程度”(默认12, 对应的分辨率为4096)

-D detail    或 --low-detail=detail               在最大级别时的“详细程度”(默认12, 对应的分辨率为4096)

-m detail      或 --minimum-detail=detail        “详细程度”下限，如果在标准“详细程度”下瓦片太大将会尝试的最小“详细程度”(默认7，对应的分辨率为128)

 

8、根据缩放级别舍弃部分要素

-r rate   或者 --drop-rate=rate     在基准级别以下的瓦片中被舍弃的点的比例(默认2.5)。 如果使用-rg，将会估算一个弃置比，保持瓦片中最多包含50,000个要素。同时也可以使用-rg width 指定一个注记宽度来允许瓦片中保持较少的要素，以适应较大的注记或标记，也可以使用-rf        number来设置瓦片中最多包含的要素数量。

-B zoom   或者 --base-zoom=zoom   基准级别及以上的瓦片将不做点状数据的抽稀 (默认为最大级别）。如果使用了-Bg，将会根据最大要素数50,000估算基准级别。同时也可以使用-Bg width 指定一个注记宽度来允许瓦片中保持较少的要素，以适应较大的注记或标记，也可以使用-Bf number 来设置瓦片中最多包含的要素数量。

-al  或者 --drop-lines      让线要素跟点要素一样，在低级别做数据抽稀

-ap 或者 --drop-polygons    让面要素跟点要素一样，在低级别做数据抽稀

 

9、舍弃一小部分要素来保持瓦片大小不超限

-as     或者 --drop-densest-as-needed             如果瓦片太大，尝试增加要素之间的最小间隔来将瓦片大小控制在500kb以下。这种显示间距将会被应用到所有级别的瓦片。

-ad    或者   --drop-fraction-as-needed             从每一个级别动态舍弃一部分要素来保持瓦片大小不超过500kb限制。 (类似于-pd，但是是应用于整个级别，而不是每一个瓦片)

-an    或者   --drop-smallest-as-needed            从每一个级别动态舍弃最小的要素(物理上的最小：最短的线或最小的面)来保持瓦片大小不超过500kb限制。该选项对点状要素无效。

-pd    或者   --force-feature-limit                        动态舍弃部分要素来保持瓦片大小不超过500kb限制(该选项与 -ad 类似，但是是针对每个单独的瓦片，而不是整个缩放级别)。该选项可能会导致瓦片边界区域比较难看，一般情况不建议使用。

 

10、舍弃紧密交错的要素

-g gamma    或者 --gamma=_gamma_                 特别密集的点将会被丢弃的比例 (默认0，不丢弃)。gamma值为2表示减少小于一个像素的点，直到其数量减少到原始数量的平方根。

-aG     或者 --increase-gamma-as-needed                如果瓦片太大，尝试使用-g增加gamma值来将瓦片大小控制在500kb以下。这个gamma值将会被应用到整个缩放级别，一般情况下会使用--drop-densest-as-needed代替该命令。

 

11、线和面的简化

-S scale  或者--simplification=scale          简化线和面

-ps  或者 --no-line-simplification               禁止简化线和面

-pS  或者 --simplify-only-low-zooms          禁止在最大级别简化线和面 (在低级别仍然执行简化)

-pt  或者   --no-tiny-polygon-reduction       不要将非常小的多边形区域合并为代表其合并区域的小正方形。