DataSourceOptions interface
A data source for managing shape data that will be displayed on the map.
A data source must be added to a layer before it is visible on the map.
Options for a DataSourceOptions
.
- Extends
Properties
buffer | The size of the buffer around each tile.
A buffer value of 0 will provide better performance but will be more likely to generate artifacts when rendering.
Larger buffers will produce left artifacts but will result in slower performance.
default |
cluster | A boolean indicating if Point features in the source should be clustered or not.
If set to true, points will be clustered together into groups by radius.
default |
cluster |
The maximum zoom level in which to cluster points.
Defaults to one zoom less than |
cluster |
Minimum number of points necessary to form a cluster if clustering is enabled. |
cluster |
Defines custom properties that are calculated using expressions against all the points within each cluster and added to the properties of each cluster point. |
cluster |
The radius of each cluster in pixels.
default |
filter | An expression for filtering features prior to processing them for rendering. |
generate |
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. |
line |
Specifies whether to calculate line distance metrics.
This is required for line layers that specify |
max |
Maximum zoom level at which to create vector tiles (higher means greater detail at high zoom levels).
default |
promote |
A specified property name to be used as a feature ID (for feature state).
This can either be a property name or an object in the form |
tolerance | The Douglas-Peucker simplification tolerance that is applied to the data when rendering (higher means simpler geometries and faster performance).
default |
Property Details
buffer
The size of the buffer around each tile.
A buffer value of 0 will provide better performance but will be more likely to generate artifacts when rendering.
Larger buffers will produce left artifacts but will result in slower performance.
default 128
buffer?: number
Property Value
number
cluster
A boolean indicating if Point features in the source should be clustered or not.
If set to true, points will be clustered together into groups by radius.
default false
cluster?: boolean
Property Value
boolean
clusterMaxZoom
The maximum zoom level in which to cluster points.
Defaults to one zoom less than maxZoom
so that last zoom features are not clustered.
clusterMaxZoom?: number
Property Value
number
clusterMinPoints
Minimum number of points necessary to form a cluster if clustering is enabled.
clusterMinPoints?: number | undefined
Property Value
number | undefined
clusterProperties
Defines custom properties that are calculated using expressions against all the points within each cluster and added to the properties of each cluster point.
clusterProperties?: Record<string, AggregateExpression>
Property Value
Record<string, AggregateExpression>
clusterRadius
The radius of each cluster in pixels.
default 50
clusterRadius?: number
Property Value
number
filter
An expression for filtering features prior to processing them for rendering.
filter?: any
Property Value
any
generateId
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.
generateId?: boolean | undefined
Property Value
boolean | undefined
lineMetrics
Specifies whether to calculate line distance metrics.
This is required for line layers that specify lineGradient
values.
default false
lineMetrics?: boolean
Property Value
boolean
maxZoom
Maximum zoom level at which to create vector tiles (higher means greater detail at high zoom levels).
default 18
maxZoom?: number
Property Value
number
promoteId
A specified property name to be used as a feature ID (for feature state).
This can either be a property name or an object in the form {<sourceLayer>: <propertyName>}
.
promoteId?: [key: string]: string | string | undefined
Property Value
[key: string]: string | string | undefined
tolerance
The Douglas-Peucker simplification tolerance that is applied to the data when rendering (higher means simpler geometries and faster performance).
default 0.375
tolerance?: number
Property Value
number