com.supermap.web.clustering
public class Clusterer
继承 Clusterer Inheritance flash.events.EventDispatcher
子类 CenterClusterer, RegionClusterer, WeightedClusterer

聚散显示父类.

聚散显示是指将一定范围内的点要素聚合显示至一个点(聚合点,地图单位。其中包括聚散中心坐标、权重、离散点集合等,离散点即为被聚合的点),详细应用请参见 SuperMap iClient 8C for Flash SampleCode。该类是 GridClusterer、RegionClusterer、WeightedClusterer 类的基类,用户也可继承该类自定义聚散显示类型。



公共属性
  属性 定义方
    clusterWeightFunction : Function
获取或设置 Clusterer 的权重计算方法,用于定义每个聚合点的权重大小,默认为:cluster.weight = cluster.features.length,即该聚合点所包含的离散点个数。
Clusterer
    featureToGeoPointFunction : Function
获取或设置将被聚合点要素 Feature(即被聚合的离散点)的几何属性转换 geometry 为 GeoPoint 对象的方法。默认方法为 feature.geometry as GeoPoint(针对点要素).
Clusterer
    levels : int
获取或设置一个图层中聚合点显示大小的最大分级数目,该属性可设置的最大值为 10.
Clusterer
    maxCount : int
获取 Clusterer 的最大聚合点数。
Clusterer
    maxWeight : Number
获取 Clusterer 的最小权重值。
Clusterer
    minCount : int
获取 Clusterer 的最小聚合点数。
Clusterer
    minFeatureCount : int
获取或设置 Clusterer 的最小聚合个数,即一个聚合点最少包含的离散点个数。当小于该值时则不聚合。
Clusterer
    minWeight : Number
获取 Clusterer 的最小权重值。
Clusterer
    size : Number
获取或设置聚合区域(栅格类型)的大小。该属性只针对 CenterClusterer 和 WeightedClusterer,单位:像素。
Clusterer
    style : Style
获取或设置聚合点显示风格。
Clusterer
公共方法
  方法 定义方
   
初始化 Clusterer 类的新实例。
Clusterer
   
clusterFeatures(featuresLayer:FeaturesLayer, featureCollection:ArrayCollection):Array
获取符合聚散显示条件的要素集合。.
Clusterer
   
destroy(featuresLayer:FeaturesLayer):void
销毁 Clusterer。
Clusterer
   
initialize(featuresLayer:FeaturesLayer):void
初始化 Clusterer。
Clusterer
受保护的方法
  方法 定义方
   
calculateClusterWeights(clusters:Dictionary):void
根据聚合点的属性计算聚合点的权重。
Clusterer
   
createClusterFeature(cluster:Cluster, arr:Array):void
根据聚合点生成离散点要素集合。 若聚合点所包含的离散点个数小于等于 minFeatureCount,则生成 Feature 对象的集合。若大于,则生成 ClusterFeature 对象集合。 ClusterFeature 类继承于 Feature 类,其中除了包括 Feature 对象所具有的属性外,还包括其所在的聚合点信息。
Clusterer
   
派发 flash.events.Event.CHANGE 事件。
Clusterer
属性详细信息
clusterWeightFunction 属性
clusterWeightFunction:Function

获取或设置 Clusterer 的权重计算方法,用于定义每个聚合点的权重大小,默认为:cluster.weight = cluster.features.length,即该聚合点所包含的离散点个数。


Implementation
    public function get clusterWeightFunction():Function
    public function set clusterWeightFunction(value:Function):void
featureToGeoPointFunction 属性  
featureToGeoPointFunction:Function

获取或设置将被聚合点要素 Feature(即被聚合的离散点)的几何属性转换 geometry 为 GeoPoint 对象的方法。默认方法为 feature.geometry as GeoPoint(针对点要素).

对于线或面要素而言,该方法可以取线或面的标识点(如:线中心点,面重心点)做为被聚合点。


Implementation
    public function get featureToGeoPointFunction():Function
    public function set featureToGeoPointFunction(value:Function):void
levels 属性  
levels:int

获取或设置一个图层中聚合点显示大小的最大分级数目,该属性可设置的最大值为 10.

每个聚合点可以根据权重显示为不同的大小。

默认值为: 5.


Implementation
    public function get levels():int
    public function set levels(value:int):void
maxCount 属性  
maxCount:int

获取 Clusterer 的最大聚合点数。


Implementation
    public function get maxCount():int
    public function set maxCount(value:int):void
maxWeight 属性  
maxWeight:Number

获取 Clusterer 的最小权重值。


Implementation
    public function get maxWeight():Number
    public function set maxWeight(value:Number):void
minCount 属性  
minCount:int

获取 Clusterer 的最小聚合点数。


Implementation
    public function get minCount():int
    public function set minCount(value:int):void
minFeatureCount 属性  
minFeatureCount:int

获取或设置 Clusterer 的最小聚合个数,即一个聚合点最少包含的离散点个数。当小于该值时则不聚合。

默认值为: 1.


Implementation
    public function get minFeatureCount():int
    public function set minFeatureCount(value:int):void
minWeight 属性  
minWeight:Number

获取 Clusterer 的最小权重值。


Implementation
    public function get minWeight():Number
    public function set minWeight(value:Number):void
size 属性  
size:Number

获取或设置聚合区域(栅格类型)的大小。该属性只针对 CenterClusterer 和 WeightedClusterer,单位:像素。


Implementation
    public function get size():Number
    public function set size(value:Number):void
style 属性  
style:Style

获取或设置聚合点显示风格。

默认值为: SimpleClusterStyle.


Implementation
    public function get style():Style
    public function set style(value:Style):void

另请参见

构造函数详细信息
Clusterer () 构造函数
public function Clusterer()

初始化 Clusterer 类的新实例。

方法详细描述
calculateClusterWeights () 方法
protected function calculateClusterWeights(clusters:Dictionary):void

根据聚合点的属性计算聚合点的权重。

参数

clusters:Dictionary — 聚合点集合。

clusterFeatures () 方法  
public function clusterFeatures(featuresLayer:FeaturesLayer, featureCollection:ArrayCollection):Array

获取符合聚散显示条件的要素集合。.

被聚散显示的离散点的几何属性必须能被转换为具有地图坐标的 GeoPoint 对象。

参数

featuresLayer:FeaturesLayer — 被聚散显示的要素所在的要素图层。
 
featureCollection:ArrayCollection — 离散点集合。

返回
Array — 符合聚散显示条件的要素集合。
createClusterFeature () 方法  
protected function createClusterFeature(cluster:Cluster, arr:Array):void

根据聚合点生成离散点要素集合。

若聚合点所包含的离散点个数小于等于 minFeatureCount,则生成 Feature 对象的集合。若大于,则生成 ClusterFeature 对象集合。 ClusterFeature 类继承于 Feature 类,其中除了包括 Feature 对象所具有的属性外,还包括其所在的聚合点信息。

参数

cluster:Cluster — 聚合点,其中包括聚散中心坐标、权重、被聚合点集合等。
 
arr:Array — 存储离散点的集合

另请参见

destroy () 方法  
public function destroy(featuresLayer:FeaturesLayer):void

销毁 Clusterer。

参数

featuresLayer:FeaturesLayer — 与 Clusterer 关联的要素图层。

dispatchEventChange () 方法  
protected function dispatchEventChange():void

派发 flash.events.Event.CHANGE 事件。

initialize () 方法  
public function initialize(featuresLayer:FeaturesLayer):void

初始化 Clusterer。

参数

featuresLayer:FeaturesLayer — 与 Clusterer 关联的要素图层。