When set to true, the maxZoom property is ignored and is instead calculated automatically based on the largest bounding box from the geoJSON features. This resolves rendering artifacts for features that use wide blur (e.g. fill extrusion ground flood light or circle layer) and would bring performance improvement on lower zoom levels, especially for geoJSON sources that update data frequently. However, it can lead to flickering and precision loss on zoom levels above 19. Default value: false.

buffer

var buffer: LongValue

Size of the tile buffer on each side. A value of 0 produces no buffer. A value of 512 produces a buffer as wide as the tile itself. Larger values produce fewer rendering artifacts near tile edges and slower performance. Default value: 128. Value range: 0, 512

cluster

var cluster: BooleanValue

If the data is a collection of point features, setting this to true clusters the points by radius into groups. Cluster groups become new Point features in the source with additional properties:

clusterMaxZoom

var clusterMaxZoom: LongValue

Max zoom on which to cluster points if clustering is enabled. Defaults to one zoom less than maxzoom (so that last zoom features are not clustered). Clusters are re-evaluated at integer zoom levels so setting clusterMaxZoom to 14 means the clusters will be displayed until z15.

clusterMinPoints

var clusterMinPoints: LongValue

Minimum number of points necessary to form a cluster if clustering is enabled. Defaults to 2.

clusterProperties

var clusterProperties: ClusterProperties

An object defining custom properties on the generated clusters if clustering is enabled, aggregating values from clustered points. Has the form {"property_name": [operator, map_expression]}. operator is any expression function that accepts at least 2 operands (e.g. "+" or "max") — it accumulates the property value from clusters/points the cluster contains; map_expression produces the value of a single point.

clusterRadius

var clusterRadius: LongValue

Radius of each cluster if clustering is enabled. A value of 512 indicates a radius equal to the width of a tile. Default value: 50. Minimum value: 0.

data

var data: GeoJSONData

Sets GeoJson data property as GeoJSONData.

generateId

var generateId: BooleanValue

Whether to generate ids for the GeoJSON features. When enabled, the feature.id property will be auto assigned based on its index in the features array, over-writing any previous values. Default value: false.

lineMetrics

var lineMetrics: BooleanValue

Whether to calculate line distance metrics. This is required for line layers that specify line-gradient values. Default value: false.

maxZoom

var maxZoom: LongValue

Maximum zoom level at which to create vector tiles (higher means greater detail at high zoom levels). Default value: 18.

prefetchZoomDelta

var prefetchZoomDelta: LongValue

When loading a map, if PrefetchZoomDelta is set to any number greater than 0, the map will first request a tile at zoom level lower than zoom - delta, but so that the zoom level is multiple of delta, in an attempt to display a full map at lower resolution as quick as possible. It will get clamped at the tile source minimum zoom. Default value: 4.

promoteId

var promoteId: PromoteIdValue

A property to use as a feature id (for feature state). Either a property name, or an object of the form {<sourceLayer>: <propertyName>}.

sourceId

val sourceId: String

tileCacheBudget

var tileCacheBudget: TileCacheBudget

This property defines a source-specific resource budget, either in tile units or in megabytes. Whenever the tile cache goes over the defined limit, the least recently used tile will be evicted from the in-memory cache. Note that the current implementation does not take into account resources allocated by the visible tiles.

tolerance

var tolerance: DoubleValue

Douglas-Peucker simplification tolerance (higher means simpler geometries and faster performance). Default value: 0.375.

GeoJsonSourceState

See also

Parameters

Constructors

Types

Functions

Properties