Cluster Layer

The Cluster Layer visualizes aggregated data based on a geospatial radius. This layer is particularly useful for gathering insight from an area, grouping nearby points into a single entity.

An example of the Cluster Layer.

An example of the Cluster Layer.


The following sections detail every setting available for the Cluster Layer.


Core settings for the Cluster layer.

Layer TypeMust be Cluster to display the Cluster Layer.
DatasetThe dataset to use for the Cluster Layer.
ColumnsSpecify a latitude and longitude column.


Color settings for the clusters.

Color ScaleThe color scale and palette for the cluster color.
Color Based OnThe field to base the cluster on.
Aggregate Magnitude ByHow to determine the magnitude of the aggregated points. Choose from standard aggregation options such as count, max, sum, and more.
OpacityThe opacity of the clusters. 100 = fully opaque, 0 = fully transparent.


Radius settings for the clusters.

Cluster Radius in PixelsThe radius in pixels to cluster points. Increase to create less clusters, decrease to create more clusters.
Radius Range in PixelsThe range of radius sizes.

JSON Schema

For details on how to programmatically specify layer properties, refer to the Layer Configuration specification