Each source can include a [sources.tippecanoe] section to fine-tune how Tippecanoe generates tiles. All settings are optional.
[[sources]]
name = "basemap"
mbtiles_path = "./basemap.mbtiles"
min_zoom = 0
max_zoom = 14
[sources.tippecanoe]
drop_densest_as_needed = true
no_tile_size_limit = true
no_feature_limit = true
buffer = 5
full_detail = 12
extra_args = ["--cluster-distance=10"]| Setting | Tippecanoe flag | Description |
|---|---|---|
drop_densest_as_needed |
--drop-densest-as-needed |
Drop features in the densest areas to stay under tile size limits |
drop_fraction_as_needed |
--drop-fraction-as-needed |
Drop a fraction of features at random |
drop_smallest_as_needed |
--drop-smallest-as-needed |
Drop the smallest features first |
coalesce_densest_as_needed |
--coalesce-densest-as-needed |
Merge nearby features in dense areas |
extend_zooms_if_still_dropping |
--extend-zooms-if-still-dropping |
Continue to higher zooms if features are still being dropped |
drop_rate |
--drop-rate |
Rate at which features are dropped at lower zooms (default: 2.5) |
base_zoom |
--base-zoom |
Base zoom level for drop rate calculation |
simplification |
--simplification |
Simplification factor in tile coordinate units |
detect_shared_borders |
--detect-shared-borders |
Detect and simplify shared polygon borders identically |
no_tiny_polygon_reduction |
--no-tiny-polygon-reduction |
Don't collapse very small polygons into single pixels |
no_feature_limit |
--no-feature-limit |
Remove the default 200,000 feature-per-tile limit |
no_tile_size_limit |
--no-tile-size-limit |
Remove the default 500KB tile size limit (default: true) |
no_tile_compression |
--no-tile-compression |
Don't gzip-compress PBF tile data |
buffer |
--buffer |
Pixel buffer around each tile edge |
full_detail |
--full-detail |
Detail level at max zoom (2^n coordinate units) |
low_detail |
--low-detail |
Detail level at lower zoom levels |
minimum_detail |
--minimum-detail |
Minimum detail level below which features are dropped |
extra_args |
(any) | Array of additional raw Tippecanoe arguments |
The extra_args field is an escape hatch for any Tippecanoe option not explicitly modeled. Each array element is passed as a separate argument.