EntityCluster

new Cesium.EntityCluster(options)
DataSources/EntityCluster.js 69

Defines how screen space objects (billboards, points, labels) are clustered.
Name Type Description
options Object optional An object with the following properties:
Name Type Default Description
enabled Boolean false optional Whether or not to enable clustering.
pixelRange Number 80 optional The pixel range to extend the screen space bounding box.
minimumClusterSize Number 2 optional The minimum number of screen space objects that can be clustered.
Demo:

Members

clusterEvent : Event
DataSources/EntityCluster.js 467

Gets the event that will be raised when a new cluster will be displayed. The signature of the event listener is EntityCluster~newClusterCallback.

enabled : Boolean
DataSources/EntityCluster.js 425

Gets or sets whether clustering is enabled.

minimumClusterSize : Number
DataSources/EntityCluster.js 453

Gets or sets the minimum number of screen space objects that can be clustered.

pixelRange : Number
DataSources/EntityCluster.js 439

Gets or sets the pixel range to extend the screen space bounding box.

Methods

destroy() → undefined
DataSources/EntityCluster.js 755

Destroys the WebGL resources held by this object. Destroying an object allows for deterministic release of WebGL resources, instead of relying on the garbage collector to destroy this object.

Unlike other objects that use WebGL resources, this object can be reused. For example, if a data source is removed from a data source collection and added to another.

Returns:

Type Definitions

newClusterCallback(clusteredEntities, cluster)
DataSources/EntityCluster.js 791

A event listener function used to style clusters.
Name Type Description
clusteredEntities Array.<Entity> An array of the entities contained in the cluster.
cluster Object An object containing billboard, label, and point properties. The values are the same as billboard, label and point entities, but must be the values of the ConstantProperty.
Example:
// The default cluster values.
dataSource.clustering.clusterEvent.addEventListener(function(entities, cluster) {
    cluster.label.show = true;
    cluster.label.text = entities.length.toLocaleString();
});