Clustering

The Essentials Clustering feature is only available for ArcGIS Server feature layers.

If the features in a feature layer are close together at the current zoom level, their symbols overlap. This makes the features difficult to distinguish. Clustering resolves this issue by using a single symbol to represent features that are close together. The cluster symbol displays the number of features that it represents. Users can click a cluster symbol to see the feature descriptions of the features in the cluster. Panning or zooming the map updates the clusters.

Crime data unclustered (left) and clustered (right)

You can configure the default visibility of clustering, and you can enable end users to turn clustering on and off.

Clustering works for feature layers from feature services only. It does not work for feature layers from map services or for other types of service or layer.

Clustering is one method of visualizing data. Heat maps offer another method.

When a user clicks a cluster symbol in an HTML5 viewer, the cluster symbol is replaced by the symbols for the individual features and all of the other clusters are hidden. A map tip that lists the cluster's features opens as well.

Clicking a cluster symbol (left) shows the individual features and a map tip (right)

Cluster symbols show in the map legend and in legend swatches in the Layer List. At most four cluster symbols show.

Cluster symbols in the map legend

Viewers support exporting, printing, and reporting of map images with clusters. Exporting the map image when clusters show on the map produces an image that is nearly identical to the map image in the viewer. Map images in printouts and reports may not look exactly like the map in the viewer. The map image has to fit in the frame that is defined in the print or report template, and the frame's proportions may be different than the map's proportions in the viewer. As well, the scale in the viewer may be different than the scale that is used to produce the printout or report. Printing and reporting recalculate the clusters so the clusters are accurate for the scale and proportions used in the printout or report.

Viewers support clustering on point layers only. Viewers do not support clustering on line and polygon layers.

You may want to remove clustering from line and polygon feature layers. If you allow end users to turn on clustering for a line or polygon layer, it will not have any effect on the map.

Clustering Settings

Clustering has the following settings:

Configure Clustering

To configure clustering:

  1. In Manager, edit the map service that you want to configure.

    Make sure you edit the feature layer's map service component, not the layer component.

  2. Click the Feature Clustering tab.

  3. Configure the settings.

  4. Click Apply Settings.

  5. Click Save Site.

  6. Test your configuration in the viewer to make sure that the radius and cluster size are appropriate for the layer's visible scales.

    The effectiveness of clustering depends on balancing the radius with the cluster size, so the clusters are dense enough but not too dense at the layer's visible scales.

Remove Clustering from a Layer

When you remove clustering from a layer, end users cannot turn clustering back on.

To remove clustering from a layer:

The HTML5 Viewer does not support clustering on line and polygon layers. You may want to remove clustering from line and polygon feature layers. If you do not remove clustering, users will be able to select clustering in the Visualization Options panel, but it will not have any effect.

  1. In Manager, edit the map service that you want to configure.

    Make sure you edit the feature layer's map service component, not the layer component.

  2. Click the Feature Clustering tab.

  3. Clear the Enabled checkbox.

  4. Clear the User Can Enable/Disable checkbox.

  5. Click Apply Settings.

© 2019 Latitude Geographics Group Ltd. All Rights Reserved.

Documentation Version 4.11