ClusteringFeatureReduction class final

Method for aggregating and summarizing features in a point FeatureLayer or point graphics in a GraphicsOverlay in dynamic rendering mode (FeatureRenderingMode.dynamic, or GraphicsRenderingMode.dynamic).

Clustering is configured via the FeatureLayer.featureReduction property of the FeatureLayer or the GraphicsOverlay.featureReduction of the GraphicsOverlay.

Feature clustering allows you to visually represent large numbers of point geoelements in relatively small areas by aggregating them into clusters. Each cluster of two or more points is represented with an AggregateGeoElement that has its own symbol. If a point feature is not clustered, it continues to draw as an individual feature using the layer's renderer. As a user navigates the map, clusters update dynamically depending on the map's scale and extent. Feature clustering only applies to layers with point geometries in a 2D map. It does not apply to layers with polyline and polygon geometries and is not supported in 3D. In such unsupported scenarios, the original features or graphics are drawn. In case of FeatureLayer, a LayerViewState is bubbled up indicating the appropriate error. The symbol for the cluster is determined by the renderer passed to ClusteringFeatureReduction and cluster symbol size is determined by the ClusteringFeatureReduction.minSymbolSize and ClusteringFeatureReduction.maxSymbolSize properties. At present, this API does not support configuring cluster symbol size from another AggregateField.