文档

符号聚合层(v3.x版本)

更新时间:

本文介绍符号聚合层的图表样式和各配置项的含义。

图表样式

符号聚合层是基础平面地图 3.0的子组件,支持独立的样式和数据配置,包括符号的尺寸大小、颜色和标注等,能够以聚合符号的形式表现地理位置上的点的分布密度。

image

配置面板

image
  • 搜索配置:单击配置面板右上角的搜索配置,可在搜索配置面板中输入您需要搜索的配置项名称,快速定位到该配置项,系统支持模糊匹配。详情请参见搜索资产配置
  • 通用:设置符号聚合层的通用配置项。

    参数

    说明

    可见级别

    设置符号聚合层的可见级别值,在设定的级别范围内符号聚合层可见,级别之外不可见。

    不透明度

    设置符号聚合层的不透明度值,取值范围为0~100,单位%,数值越大图层越不透明。

  • 图形:设置符号聚合层的图形配置项。image

    参数

    说明

    聚合形状

    设置符号聚合形状的样式,可选矢量符号

    说明

    矢量类型支持描边;符号类型不支持描边。

    矢量形状

    设置矢量型聚合图型的形状样式,可选圆形六边形两种。仅在聚合形状选中为矢量时可配置。

    符号形状

    设置符号型聚合图型的形状样式,内置多种图形样式。仅在聚合形状选中为符号时可配置。

    形状半径

    设置矢量型聚合图型的形状半径大小值,请参见尺寸映射器使用说明,配置不同符号的映射半径尺寸样式。

    填充颜色

    设置矢量型聚合图型的填充颜色,请参见颜色映射器使用说明,配置不同符号的映射颜色样式。

    矢量描边

    设置矢量聚合图型的描边线的颜色和描边线的粗细值,取值范围为0~20,单位px。仅在聚合形状选中为矢量时可配置。

    聚合标注

    符号聚合时标注的文本样式,包括标注的字体样式、文字粗细、字号大小和颜色。

    单点图标

    设置单个符号点图标的样式。

    • 图标形状:设置单点图标的形状样式,可参见形状映射器使用说明,配置不同符号的映射形状样式。

    • 图标尺寸:拖动滑块设置单点图标的尺寸,包括图标的宽度和高度的值,单位px。

    • 相对位置:设置图标与符号点的相对位置样式,包括底部中心

    • 相对偏移:设置图标在水平和垂直方向的相对偏移值,取值范围为-100~100,单位px。

  • 标签:设置符号聚合层内标签的样式参数。image

    参数

    说明

    显示标签

    打开开关,符号聚合层显示标签样式。

    显示方式

    设置符号聚合层的标签显示的方式,可选,包括全显点击悬浮三种方式。

    相对位置

    设置符号聚合层的标签的相对位置样式,可选,包括左侧中心右侧顶部底部

    相对偏移

    设置符号聚合层的标签在水平和垂直方向的相对偏移值,单位px,取值范围为-100~100。

    内容样式

    设置符号聚合层标签的内容样式。单击每行样式右侧的加号图标垃圾桶图标图标,添加或删除一个每行内容样式。 单击横排列图标竖排列图标图标配置多个每行内容样式的排列方式。单击复制图标图标,即可复制当前选中的每行样式配置并新增一个同样配置的每行样式。

    • 行字段:行内容的字段名称,需要和数据面板中的字段相匹配。

    • 字段样式:设置行字段样式,包括字段的字体样式、字号大小、颜色和粗细值。

    • 字段前缀:设置字段前缀的具体内容 、内容间隔值、字体、字号大小、颜色和粗细值。单击字段前缀左侧的眼睛图标图标,可控制字段前缀样式的显隐。

    • 字段后缀:设置字段后缀的具体内容 、内容间隔值、字体、字号大小、颜色和粗细值。单击字段后缀左侧的眼睛图标图标,可控制字段后缀样式的显隐。

    • 字段宽度:标签的显示字段的宽度样式,包括字段的适应类型方式,可选自适应固定宽度,并根据适应类型设置字段宽度的值,单位px。

    • 行高比例:标签的行高比例值,取值范围为1~2。

    • 内容描边:标签的内容描边样式,包括设置描边的颜色和描边粗细值,单击内容描边左侧的眼睛图标图标,可控制内容描边的显隐。

    • 内容阴影:标签的内容阴影样式,包括设置阴影的颜色、阴影模糊值和阴影偏移度在x和y方向上的值,单击内容阴影左侧的眼睛图标图标,可控制内容阴影的显隐。

    背景样式

    设置符号聚合层内标签的背景样式参数,单击背景样式左侧的眼睛图标图标,可控制背景样式的显隐。

    • 背景类型:标签背景的类型,可选矢量图片

    • 背景颜色:设置标签的背景颜色,仅在背景类型选择矢量时可配置。

    • 边框样式:设置标签边框的样式,包括边框的线类型,线宽的值和颜色。仅在背景类型选择矢量时可配置。

    • 边框圆角:设置标签边框的圆角在四个方向的值,单位px。仅在背景类型选择矢量时可配置。

    • 图片模板:选择背景图片的模板样式,仅在图片模板选择图片时可配置。

    • 不透明度:设置背景图片的不透明度值,取值范围为0~100,仅在图片模板选择图片时可配置。

    • 内容边距:设置标签中的内容距离上下左右四个方向的边距值。

  • 交互:符号聚合层的交互配置项。

    • 图形交互:在预览或发布页面,单击符号时出现的图形交互样式。单击图形交互左侧的眼睛图标图标,可控制图形交互的显隐。

      参数

      说明

      尺寸缩放

      拖动滑块设置符号尺寸缩放的范围,取值范围为1~2。

      点击聚焦

      拖动滑块,设置当点击符号时的视角聚焦的范围值,取值范围为1~10。

  • 条件:条件样式说明。image

    条件样式:单击右侧的加号图标垃圾桶图标图标,添加或删除一个条件样式。 单击横排列图标竖排列图标图标配置多个条件样式的排列样式。单击复制图标图标,即可复制当前选中条件样式配置内容并新增一个同样配置的条件样式。具体配置请参见条件树使用说明

    图形:打开开关,配置该样式中的图形配置项;关闭开关,无法配置该样式下的图形配置项。

    参数

    说明

    图标形状

    单击图标形状左侧的眼睛图标图标,可控制该条件下的符号形状样式的显隐。

    图标尺寸

    单击图标尺寸左侧的眼睛图标图标,可控制该条件下的符号在宽度和高度的尺寸样式显隐。

    相对位置

    单击相对位置左侧的眼睛图标图标,可控制该条件下的符号相对位置样式显隐。

    相对偏移

    单击相对偏移左侧的眼睛图标图标,可控制该条件下的符号在水平和垂直方向相对偏移量样式显隐。

  • 自定义弹框样式:设置符号聚合层内自定义弹框的样式参数。image

    参数

    说明

    弹框开关

    打开开关,可以通过点击悬浮触发弹框。

    显示方式

    设置符号聚合层弹框显示的方式,可选,包括点击悬浮两种方式。

    相对偏移

    设置弹窗在水平和垂直方向的相对偏移像素距离,取值范围为-1000~1000,单位px。

    文本样式

    设置弹框内的文本样式,包括文本的字体样式、字号大小、颜色和文本粗细值。

    显示空值

    打开开关,在无info字段或空info字段对象上可以弹框显示为“无数据”。

    弹框样式

    • 内边距:设置弹框文本的内容距离上下左右四个方向的边距值。

    • 边框样式:设置弹框边框的圆角值、线宽和颜色。

    • 背景颜色:设置弹框的背景颜色。

    • 投影样式:设置弹框投影的模糊色、模糊半径、X偏移和Y偏移。

    • 关闭按钮:打开开关,符号聚合层的弹框显示关闭按钮和按钮的颜色。

    • 指向箭头:打开开关,符号聚合层的弹框显示指向箭头。

数据面板(默认方式)

image

配置字段说明

字段

说明

type

符号点的数据分类。

name

(可选)符号点的标注名称。

lng

符号点的经度。

lat

符号点的纬度。

value

(可选)符号点在配置项内用于数据映的值,缺失则按无数据配置渲染。

id

(可选)符号点的唯一标识信息。

iconField

(可选)符号点的形状映射字段。

popupType

(可选)弹框类型(需要搭配二次开发功能使用)。

info

(可选)自定义弹框内容。

表 1. 配置项说明
配置项说明
受控模式打开开关,资产初始化状态下不请求数据,仅通过回调ID或蓝图编辑器配置的方法发起请求数据;关闭开关,可以使用自动更新请求数据。开关默认为关闭状态。
自动更新请求选中后可以设置动态轮询,还可以手动输入轮询的时间频次。取消选中后则不会自动更新,需要手动刷新页面,或通过蓝图编辑器和回调ID事件来触发请求更新数据。
数据源单击配置数据源,可在设置数据源面板中修改数据源类型和数据查询代码、预览数据源返回结果以及查看数据响应结果,详情请参见配置资产数据
数据过滤器数据过滤器提供数据结构转换、筛选和一些简单的计算功能。单击添加过滤器,可在设置数据源面板配置数据过滤器脚本,详情请参见过滤器使用说明
数据响应结果展示数据请求的响应结果。当数据源发生改变时,可单击右侧的刷新图标 图标,实时查看数据响应结果。

数据面板(分析模式)

image

符号聚合层子组件BI分析数据配置面板中的详细操作说明,请参见BI分析模式数据面板功能介绍

配置字段说明

字段

说明

lng

符号点的经度。

lat

符号点的纬度。

type

符号点的数据分类。

name

(可选)符号点的标注名称。

value

(可选)符号点在配置项内用于数据映的值,缺失则按无数据配置渲染。

id

(可选)符号点的唯一标识信息。

iconField

(可选)符号点的形状映射字段。

popupType

(可选)弹框类型(需要搭配二次开发功能使用)。

info

(可选)自定义弹框内容。

交互面板

image

交互说明

交互

说明

当点击点时

选中启用,开启组件交互功能。符号聚合层子组件拥有交互配置,当单击某个符号点时抛出回调值,默认抛出数据中的lnglat字段。具体配置请参见如何配置数字翻牌器组件的回调ID

当鼠标移入时

选中启用,开启组件交互功能。符号聚合层子组件拥有交互配置,当鼠标移入到符号点位置时抛出回调值,默认抛出数据中的lnglat字段。具体配置请参见如何配置数字翻牌器组件的回调ID

蓝图编辑器交互配置

  1. 在画布编辑器页面,单击基础平面地图 3.0子组件管理列表中符号聚合层右侧的导出到蓝图编辑器图标。

  2. 单击页面左上角的蓝图图标图标。

  3. 在蓝图编辑器配置页面,单击导入节点栏内的符号聚合层组件,在画布中可以看到如下图所示的符号聚合层的蓝图编辑器配置参数。蓝图参数

    • 事件

      事件

      说明

      当数据接口请求完成时

      数据接口请求返回并经过过滤器处理后抛出的事件,同时抛出处理后的JSON格式的数据。具体数据示例请参见画布编辑器中组件右侧配置面板数据页签的数据响应结果区域。

      当数据接口请求失败时

      数据接口请求失败时(请求失败的情况可能是:网络问题或接口报错等)返回并经过过滤器处理后抛出的事件,同时抛出处理后的JSON格式的数据。具体数据示例请参见画布编辑器中组件右侧配置面板数据页签的数据响应结果区域。

      当点击点时

      当单击符号聚合层的符号点时抛出的事件,同时抛出该符号点对应的经纬度数据项。

      当鼠标移入时

      当鼠标移入符号聚合层的符号点时抛出的事件,同时抛出该符号点对应的经纬度数据项。

    • 动作

      动作

      说明

      请求数据接口

      重新请求服务端数据,上游数据处理节点或图层节点抛出的数据将作为参数。例如符号聚合层配置了API数据源为https://api.test,传到请求数据接口动作的数据为{ id: '1'},则最终请求接口为https://api.test?id=1

      导入数据接口

      按组件绘制格式处理数据后,导入组件,重新绘制。不需要重新请求服务端数据。具体数据示例请参见画布编辑器中组件右侧配置面板数据页签的数据响应结果区域。

      显示

      显示组件,不需要参数。

      隐藏

      隐藏组件,不需要参数。