常用tippecanoe参数设置

    技术2022-07-11  91

     

         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       不要将非常小的多边形区域合并为代表其合并区域的小正方形。

     

    Processed: 0.011, SQL: 9