| 包 | com.supermap.web.mapping |
| 类 | public class HeatMapLayer |
| 继承 | HeatMapLayer  DynamicLayer ImageLayer Layer mx.core.UIComponent |
热点图是动态栅格图的一种。它是在二维表面上通过颜色用图示化方法来表达二维离散数据分布的一种方式。常常以一张具备显著颜色差异图片的方式呈现最终结果，暖色一般代表事件发生频率较高或事物分布密度较大，冷色反之，它能够明显的表现地图中事件发生频率或事物分布密度。
热点图生成原理是：对于整幅栅格图，每个热点（HeatPoint）给定一个缓冲半径（像素坐标系），每个像素的值根据距离从中心向外递减渐变；把每个像素所分配的值计算总和，然后再根据这个值赋予相应颜色，形成热点圆。因此生成热点图有四个相关参数：热点集合、配色方案、缓冲半径和颜色值计算。
默认 MXML 属性heatPoints
另请参见
| 属性 | 定义方 | ||
|---|---|---|---|
 |
bounds : Rectangle2D
当前图层的地理范围，若当前图层为 Map 的第一个图层，且 Map 的 ViewBounds 为 null，则将当前图层的 bounds 作为 Map 的 ViewBounds。一般情况下该属性默认值为（0,0,0,0）。若当前图层为 WMTS 图层（TiledWMTSLayer），则 bounds 的默认值参考 WMTS 标准而定...
|
Layer | |
|
CRS : CoordinateReferenceSystem
获取或设置当前图层的坐标参考系（ CoordinateReferenceSystem ）。默认值为 null。设置 CoordinateReferenceSystem.wkid 属性后，图层将被动态投影至 wkid 所代表的投影坐标系下，若 wkid 小于等于 0 则不进行动态投影...
|
Layer | |
| heatPoints : Object
获取或设置热度图中热点（HeatPoint）集合，必设属性。各热点拥有各自的坐标和所代表的值。
|
HeatMapLayer | ||
| heatStops : Array
获取或设置热点圆渐变填充中的颜色过渡站点（HeatStop）集合。其中站点的信息包括位置和颜色.
|
HeatMapLayer | ||
|
imageFormat : String
获取或设置载入 ImageLayer 的图片格式，默认为 png 格式。
|
ImageLayer | |
|
isInResolutionRange : Boolean
[read-only] 判断与当前图层关联的 Map 的分辨率是否在当前图层的最大、最小分辨率范围内。true 表示在最大、最小范围内。
|
Layer | |
|
isScaleCentric : Boolean
[read-only] 指示该图层是否有 DPI 值，ture 表示当前图层已根据从 SuperMap iServer 服务端获取的参数计算出 DPI；false 反之。WMS、WMTS 等图层该属性值为 false。DynamicRESTLayer、TiledDynamicRESTLayer 等专门关联 SuperMap iServer 服务的图层该属性为 true。
|
Layer | |
|
loaded : Boolean
[read-only] 若当前图层已加载完闭则返回 true，否则返回 false。
|
Layer | |
|
maxVisibleResolution : Number
当前图层的最大显示分辨率。即当图层缩放至该分辨率时就不能再放大。
|
Layer | |
|
metadata : Object
获取或设置当前图层信息，包括图层标题、描述信息、图层所在地图控件名称。
|
Layer | |
|
minVisibleResolution : Number
当前图层的最小显示分辨率。即当图层缩放至该分辨率时就不能再缩小。
|
Layer | |
| radius : int
获取或设置热点圆半径，即热点的缓冲半径。默认为25个像素。
|
HeatMapLayer | ||
|
resolution : Number
[read-only] 获取当前图层的显示分辨率。
|
Layer | |
| transformationFunction : Function
获取或设置将需要表达为热点图的对象转换成热点对象的转换函数.
|
HeatMapLayer | ||
|
transparent : Boolean
指定图片是否透明显示。
|
ImageLayer | |
|
url : String
图层所在的服务地址。
|
Layer | |
|
visible : Boolean
[Override] 获取或设置当前图层是否可见。
|
Layer | |
| 方法 | 定义方 | ||
|---|---|---|---|
|
初始化 HeatMapLayer 类的新实例。
|
HeatMapLayer | ||
|
refresh():void
刷新图层，即调用 Layer.invalidateDisplayList() 方法(详情请参见 Flex SDK UIComponent.invalidateDisplayList() 方法)，更新 Layer 的显示列表。对于 GraphicsLayer 调用该方法会对 GraphicsLayer 上所有显示对象 Graphic 进行重绘。
|
Layer | |
| 方法 | 定义方 | ||
|---|---|---|---|
|
addedHandler(event:Event):void
处理 Event.ADDED 事件的侦听器函数。
|
Layer | |
|
addMapListeners():void
为当前图层添加事件侦听器，以使侦听器能够接收 ZoomEvent、 ViewBoundsEvent 事件的触发通知。
|
Layer | |
|
计算图片的地理范围。
|
DynamicLayer | |
|
draw():void
[Override] 渲染出图，注意：子类必须重写该方法来实现渲染出图。
|
HeatMapLayer | ||
|
drawHeatMap():void
绘制热点图。
|
HeatMapLayer | ||
|
hideHandler(event:FlexEvent):void
[Override] 处理 FlexEvent.HIDE 事件的侦听器函数。
|
DynamicLayer | |
|
invalidateLayer():void
通过子类调用以更新图层。
|
Layer | |
|
loadMapImage(loader:Loader):void
载入图片（ PNG、JPEG ）。
|
DynamicLayer | |
|
removeAllChildren():void
删除 Layer 上的所有对象。
|
Layer | |
|
removedHandler(event:Event):void
[Override] 处理 Event.REMOVED 事件的侦听器函数。
|
DynamicLayer | |
|
removeMapListeners():void
移除通过 addMapListeners 添加的事件侦听器。
|
Layer | |
|
setLoaded(value:Boolean):void
设置图层是否加载完闭，会触发 LayerEvent.LOAD 事件。true 表示当前图层已加载完毕。注意：任何继承 Layer 的子类都必须在 Layer 初始化完成之后调用该接口设置对应的图层是否加载完毕。
|
Layer | |
|
showHandler(event:FlexEvent):void
[Override] 处理 FlexEvent.SHOW 事件的侦听器函数。
|
DynamicLayer | |
|
updatePoints():void
更新热点集合。 该方法用于将当前图层的所有热点的 Value 属性利用 weightFunction 属性转换为能够表达颜色的权重值。因此，当 HeatMapLayer 的 heatPoints 属性不为空时该方法才可执行。
|
HeatMapLayer | ||
|
viewBoundsChangedHandler(event:ViewBoundsEvent):void
处理 viewBoundsChanged 事件的侦听器函数。
|
Layer | |
|
zoomEndHandler(event:ZoomEvent):void
[Override] 处理 zoomEnd 事件的侦听器函数。
|
DynamicLayer | |
|
zoomStartHandler(event:ZoomEvent):void
[Override] 处理 zoomStart 事件的侦听器函数。
|
DynamicLayer | |
|
zoomUpdateHandler(event:ZoomEvent):void
[Override] 处理 zoomUpdate 事件的侦听器函数。
|
DynamicLayer | |
| heatPoints | 属性 |
隐藏继承的公共属性
显示继承的公共属性heatPoints:Object
获取或设置热度图中热点（HeatPoint）集合，必设属性。各热点拥有各自的坐标和所代表的值。
此属性可用作数据绑定的源。修改此属性后，将调度 Bindable 事件。
public function get heatPoints():Object public function set heatPoints(value:Object):void| heatStops | 属性 |
heatStops:Array
获取或设置热点圆渐变填充中的颜色过渡站点（HeatStop）集合。其中站点的信息包括位置和颜色.
集合中站点的排列顺序代表热点圆的颜色由冷色到暖色、由外围到中心的过渡顺序，即排列在前面的代表冷色，排列在后的代表暖色。暖色一般代表事件发生频率较高或事物分布密度较大，冷色反之。
注意：由于类库内部使 ARGB 色彩模式来渲染热点圆中的每个像素，其中颜色的取值范围在 0~255（十进制），因此该集合中的颜色过渡站点个数最多为 256 个，索引大于 255 的站点将被忽略。
此属性可用作数据绑定的源。修改此属性后，将调度 Bindable 事件。
public function get heatStops():Array public function set heatStops(value:Array):void另请参见
| radius | 属性 |
radius:int
获取或设置热点圆半径，即热点的缓冲半径。默认为25个像素。
此属性可用作数据绑定的源。修改此属性后，将调度 Bindable 事件。
public function get radius():int public function set radius(value:int):void| transformationFunction | 属性 |
transformationFunction:Function
获取或设置将需要表达为热点图的对象转换成热点对象的转换函数.
默认的转换方式如下：
private function transformationFunction(o:Object):HeatPoint { var point:Point = this.map.mapToScreen(new Point2D(o["x"], o["y"])); var value:Number = 1; if(o.hasOwnProperty("value")) { value = o["value"]; } return new HeatPoint(point.x, point.y, value); }
此属性可用作数据绑定的源。修改此属性后，将调度 Bindable 事件。
public function get transformationFunction():Function public function set transformationFunction(value:Function):void另请参见
| HeatMapLayer | () | 构造函数 |
public function HeatMapLayer()
初始化 HeatMapLayer 类的新实例。
| draw | () | 方法 |
override protected function draw():void
渲染出图，注意：子类必须重写该方法来实现渲染出图。
| drawHeatMap | () | 方法 |
protected function drawHeatMap():void
绘制热点图。
| updatePoints | () | 方法 |
protected function updatePoints():void
更新热点集合。
该方法用于将当前图层的所有热点的 Value 属性利用 weightFunction 属性转换为能够表达颜色的权重值。因此，当 HeatMapLayer 的 heatPoints 属性不为空时该方法才可执行。
另请参见