点聚合层是基础平面地图的子组件，支持独立的样式、数据和交互配置，包括聚合样式、默认散点图标样式、系列配置、弹框样式以及交互配置等，点聚合缩放到单个散点的时候，能够以散点的形式表现地理位置上的点数据信息。本文介绍点聚合层各配置项的含义。
注意 当前为v2.x版本的点聚合层子组件指导文档，如需查看该子组件v1.x版本的文档内容详情，请参见点聚合层（v1.x版本）。
配置
- 搜索配置：单击配置面板右上角的搜索配置，可在搜索配置面板中输入您需要搜索的配置项名称，快速定位到该配置项，系统支持模糊匹配。详情请参见搜索资产配置。
- 可见级别：设置点聚合层的可见级别值，在设定的级别范围内点聚合层可见，级别之外不可见。
- 聚合样式：设置散点聚合后的样式。
参数 说明 聚合图形 设置聚合时候的图形样式，可选圆形和六边形。 半径映射 打开开关，聚合时候图形的半径根据聚合范围内散点的数量多少映射对应的半径值，并且可在下方半径范围配置项中，设置图形半径映射的大小取值范围；关闭开关，可在下方半径配置项中，自定义设置一个固定的聚合图型半径值。 半径 聚合时候图形的半径值，取值范围5~100，单位px。一个聚合点的半径越大，范围内包括的散点越多。仅在关闭半径映射配置项时，可配置半径值。 半径范围 拖动左侧和右侧的滑块，调整聚合时候图形的半径最大和最小范围值，取值范围5~100，单位px。一个聚合点的半径越大，范围内包括的散点越多。仅在打开半径映射配置项时，可配置半径范围值。 填充颜色 聚合图形的填充颜色，包括最小值和最大值。 边线样式 聚合图形边线的颜色和粗细，单位为px。 文本样式 聚合图形内文本的字体、文字粗细、字号、颜色和阴影色。请参见颜色选择器说明进行修改颜色。 - 默认图标：设置散点默认情况下的图片路径、图片尺寸和相对位置等参数。
参数 说明 图片路径 在图片路径区域 - 鼠标移动到图片位置，单击删除可删除当前图片，然后单击图片区域或者拖动本地图片到区域内即可添加一个默认图标样式图。
- 鼠标移动到图片位置，单击更改可重新上传本地图片。
- 您也可以输入图片的URL地址，将远程服务器上的图片作为默认图标。
图片尺寸 设置默认图标的宽度和高度来控制图片尺寸大小。 相对位置 设置默认图标对于散点的相对位置样式，可选择底部或中心。 偏移量 设置默认图标从水平方向或者垂直方向的偏移量值。 - 系列配置：单击右侧的
或
图标，添加或删除一个系列配置。 单击
或
图标配置多个系列的排列样式。单击
图标，即可复制当前选中数据系列配置内容并新增一个同样配置的数据系列。
类型过滤值：与数据源中的type字段对应，配置您所设置的type值对应散点的类型样式。
设置每一个系列类型的图标样式，具体请参见配置下的默认图标参数来配置对应系列的图标样式。
- 弹框：在预览或发布页面，单击散点的图标出现的弹框样式。单击弹框左侧的
图标，可控制弹框的显隐。
说明 开启弹窗功能需要先设置info字段。- info字段：单击开关，开启info字段，设置info字段作为弹窗内容，该字段支持配置html标签；如果关闭info字段开关，则兼容name和value字段内容作为弹窗内容。
- 事件类型：选择通过点击或鼠标移入事件作为弹框显示的类型。
- 配置选项：弹框样式的配置项内容，可选择父容器默认或自定义配置。
- 父容器默认：系统自带的默认样式。
- 自定义配置：自定义配置弹框的文本样式、行高比例和圆角半径等参数。
参数 说明 文本样式 设置弹框内文本的字体、文字粗细、字号、颜色和阴影色，请参见颜色选择器说明进行颜色修改。 行高比例 设置弹框格式的行高比例值。 圆角半径 设置弹框的圆角半径值，数值越大圆角越圆。 外边距 设置弹框内文本与弹框四边的距离。 背景色 设置弹框的背景色。 关闭按钮 设置关闭弹框按钮的颜色、大小、按钮离顶部的距离和离右侧的距离。
- 交互配置
参数 说明 悬停样式 单击悬停样式左侧 图标，可控制悬停交互功能的开启或关闭。开启后可设置鼠标悬停聚合图标时的填充颜色和图标悬停大小相对原始大小的比例值，仅在预览或发布时才能看到效果。
点击聚焦 拖动滑块根据聚合图标的位置进行一定范围比例的聚焦，仅在预览或发布时才能看到效果。
数据
| 字段 | 说明 |
|---|---|
| lng | 散点的经度。 |
| lat | 散点的纬度。 |
| type | （可选）多系列配置，与配置面板的系列配置配合使用，来配置散点的图标样式。
说明 没有配置系列值或者不在系列值之内的散点图标样式，会使用配置面板中的默认图标进行配置。
|
| value | 可在数据面板内，自定义配置value、name或info字段，用于表示点的弹窗标注信息。 |
| name | |
| info |
| 配置项 | 说明 |
|---|---|
| 受控模式 | 打开开关，资产初始化状态下不请求数据，仅通过回调ID或蓝图编辑器配置的方法发起请求数据；关闭开关，可以使用自动更新请求数据。开关默认为关闭状态。 |
| 自动更新请求 | 选中后可以设置动态轮询，还可以手动输入轮询的时间频次。取消选中后则不会自动更新，需要手动刷新页面，或通过蓝图编辑器和回调ID事件来触发请求更新数据。 |
| 数据源 | 单击配置数据源，可在设置数据源面板中修改数据源类型和数据查询代码、预览数据源返回结果以及查看数据响应结果。详情请参见配置资产数据。 |
| 数据过滤器 | 数据过滤器提供数据结构转换、筛选和一些简单的计算功能。单击添加过滤器，可在设置数据源面板配置数据过滤器脚本，详情请参见过滤器使用说明。 |
| 数据响应结果 | 展示数据请求的响应结果。当数据源发生改变时，可单击右侧的 图标，实时查看数据响应结果。
|
交互
| 交互 | 说明 |
|---|---|
| 当点击点时 | 选中启用，开启组件交互功能。点聚合层子组件拥有交互配置，当单击某个散点时抛出回调值，默认抛出数据中的lng和lat字段。具体配置请参见组件回调ID配置。 |
| 当鼠标移入时 | 选中启用，开启组件交互功能。点聚合层子组件拥有交互配置，当鼠标移入到散点位置时抛出回调值，默认抛出数据中的lng和lat字段。具体配置请参见组件回调ID配置。 |
蓝图编辑器交互配置
- 在画布编辑器页面，单击基础平面地图子组件管理列表中点聚合层右侧的
图标。
- 单击页面左上角的
图标。
- 在蓝图编辑器配置页面，单击导入节点栏内的点聚合层组件，在画布中可以看到如下图所示的点聚合层的蓝图编辑器配置参数。
- 事件
事件 说明 当数据接口请求完成时 数据接口请求返回并经过过滤器处理后抛出的事件，同时抛出处理后的JSON格式的数据。具体数据示例请参见画布编辑器中组件右侧配置面板数据页签的数据响应结果区域。 当数据接口请求失败时 数据接口请求失败时（请求失败的情况可能是：网络问题或接口报错等）返回并经过过滤器处理后抛出的事件，同时抛出处理后的JSON格式的数据。具体数据示例请参见画布编辑器中组件右侧配置面板数据页签的数据响应结果区域。 当点击点时 当单击点聚合层的散点时抛出的事件，同时抛出该散点对应的经纬度数据项。 当鼠标移入时 当鼠标移入点聚合层的散点时抛出的事件，同时抛出该散点对应的经纬度数据项。 - 动作
动作 说明 请求数据接口 重新请求服务端数据，上游数据处理节点或图层节点抛出的数据将作为参数。例如点聚合层配置了API数据源为 http://api.test，传到请求数据接口动作的数据为{ id: '1'}，则最终请求接口为http://api.test?id=1。导入数据接口 按组件绘制格式处理数据后，导入组件，重新绘制。不需要重新请求服务端数据。具体数据示例请参见画布编辑器中组件右侧配置面板数据页签的数据响应结果区域。 显示 显示组件，不需要参数。 隐藏 隐藏组件，不需要参数。
- 事件