“周边”微件用于查找和分析定义位置指定距离内的要素。 位置可以为选定要素、绘制的图形或由其他输入方法定义的位置。 您还可以根据当前地图范围查找要素。
该微件可以执行三种类型的分析:查找最接近定义位置的要素,查找定义位置指定距离内的所有要素,并使用统计函数和 SQL 表达式汇总附近要素的数值。
注:
“周边”微件用于替换 ArcGIS Web AppBuilder 周边、态势感知、信息摘要和筛查微件的功能。 此功能大部分现已可用,将在 Experience Builder 的未来版本中逐步添加。
示例
使用此微件可支持以下应用程序设计要求:
- 您希望用户单击地图上的一个点并确定最近的投票位置。
- 您希望用户确定医院一定距离内城镇的总人口。
- 您希望用户确定一个区域中有多少建筑物符合当地的无障碍法规。
用法说明
此微件需要连接到“地图”微件。 “地图”微件必须连接到的数据源必须至少包含一个要素图层。
“周边”微件将生成可供其他微件使用的输出数据源。 最近和邻域分析工具各生成一个输出要素图层。 汇总分析工具生成两个输出要素图层,一个用于汇总统计,一个用于分析中涉及的所有要素。
设置
“周边”微件包括以下设置:
- 选择“地图”微件 - 选择“地图”微件。
- 地图或场景设置 - 单击 web 地图或 web 场景以打开地图设置面板。
- 搜索方法 - 定义微件查找要素的方式。
- 当前地图区域 - 允许用户查找当前地图范围内的要素。
- 指定位置 - 允许用户搜索输入位置一定距离内的要素。 此选项包括以下附加设置:
- 标题标注 - 自定义显示在微件左上角的标题文本。 您可以更改标注的字体、样式、颜色和大小,以像素 (px) 为单位。
- 搜索距离 - 提供搜索距离的默认值。
- 距离单位 - 为搜索距离指定默认单位。
- 输入 - 配置与用户定义输入位置的方式有关的设置。
- 距离设置 - 选中此框以允许用户在运行时更改搜索距离和单位。
- 输入位置标注 - 选中此框以在输入位置为点时让微件在运行时显示输入位置地址。
- 草图工具 - 打开这些开关以在运行时将输入位置绘图工具包含在微件面板中。
- 分析 - 定义微件分析要素的方式。
- 添加分析 - 将新的分析工具添加到微件的运行时面板。
- 选择图层 - 选择要分析的要素图层。
- 标注 - 为分析工具添加有意义的标注。
- 分析类型 - 指定分析类型:
- 最近要素 - 查找指定距离内距离输入位置最近的要素。
注:
当搜索区域设置为当前地图区域时,最近要素在此处不可用。
- 邻域分析 - 查找输入位置特定距离内的所有要素。
- 显示字段 - 指定用于识别结果列表中各个要素的字段。 默认字段为 ObjectID。
- 对要素排序 - 按距输入位置的距离或按字段升序或降序列出结果。
注:
当搜索区域设置为当前地图区域时,将默认按 ObjectID 字段对结果进行排序。 选择字段以按 ObjectID 之外的字段进行排序。
- 分组要素 - 可以选择按字段以升序或降序对要素进行分组。 此设置适用于分析分类数据。 设置分组字段后,会出现第二个字段选择器,可用于设置子分组字段。 可以选择单击设置来配置这两个字段的以下设置。
- 按计数排序组 - 按每组要素数量排序组和子组。
- “无值”组标注 - 输入一个标注,当没有要素符合组条件时显示。
- 汇总 - 使用统计函数和 SQL 表达式汇总要素的数值。
- 添加汇总 - 添加新的数据汇总。 您可以通过以下方式汇总数据:
- 统计 - 获取统计函数结果(MAX、MIN、AVERAGE 和 SUM)或选定字段的数据计数 (COUNT)。
- 表达式 - 使用五个函数运算符(AVERAGE、COUNT、SUM、MAX 和 MIN)和数据字段构建更复杂的表达式。
- 相交长度总和或相交面积总和 - 选中此框可显示搜索距离缓冲区内要素的总相交长度(对于线要素)或总面积(对于面要素)。 当连接的图层是线或面要素图层时,会显示此设置。 单击编辑按钮添加标注和格式数字。
- 颜色模式 - 指定显示背景颜色的方法,可以是单一颜色,也可以按类别显示。 然后选择颜色。 添加摘要后将显示此设置。
- 添加汇总 - 添加新的数据汇总。 您可以通过以下方式汇总数据:
- 最近要素 - 查找指定距离内距离输入位置最近的要素。
以下设置适用于所有三个分析工具:
- 在地图上高亮显示结果 - 如果启用此设置,则当用户单击并展开结果列表时,将在地图上高亮显示结果。 可以选择高亮显示颜色。
警告:
如果图层包含大量要素,则高亮显示结果可能会导致性能问题。
- 展开分析结果 - 指定默认情况下是展开还是折叠结果列表。
- 展开要素详细信息 - 对于邻域,默认情况下选中此框可展开结果列表中各个要素的详细信息。
警告:
如果图层包含大量要素,则展开所有详细信息并高亮显示结果可能会导致性能问题。
- 展开要素详细信息 - 对于邻域,默认情况下选中此框可展开结果列表中各个要素的详细信息。
- 配置导出字段 - 选择用户使用导出数据操作导出结果时,要包含的字段。
- 包含近似距离 - 对于最近要素和邻域工具,启用此设置,可在导出的 .csv、.json 和 .geojson 文件中添加近似距离字段。
- 显示要素计数 - 可选择显示每个分析工具的要素计数。
- 显示分析图标 - 可选择显示分析工具图标。
提示:
当在多个分析中多次使用同一图层时,这些图标将非常有用。
- 添加分析 - 将新的分析工具添加到微件的运行时面板。
- 结果 - 配置与分析结果在运行时的显示方式有关的设置。
- 要素计数 - 在结果中包含要素计数。
- 分析图标 - 在结果中包含每个分析工具名称旁的图标。
- 地图符号 - 包含表示满足分析条件的要素符号系统的地图符号。
注:
如果地图图层通过属性字段进行符号化,并且打开分组要素,则微件将使用该字段作为默认分组字段。
- 近似距离 - 包含指示已找到要素距离输入位置的近似距离的距离值。 显示的单位为在距离单位下设置的单位,或用户在运行时选取的单位。
- 过滤图层以仅显示结果 - 过滤图层以仅显示满足分析条件的要素。
- 搜索方法 - 定义微件查找要素的方式。
- 常规设置 - 配置以下常规设置:
- 草图颜色 - 定义使用微件的草图工具绘制的点、线和面的颜色。
- 未找到结果消息 - 自定义未找到任何要素时显示在微件中的文本。 您可以更改文本的字体、笔划、颜色和大小(以像素 (px) 为单位)。
- 自定义欢迎消息 - 自定义首次加载微件时显示的文本。 可以使用此文本来提供说明。 当用户运行分析后,此文本将消失。
允许导出
“周边”微件可以将结果导出为 .csv、.json 或 .geojson 文件。 要允许用户导出结果,请确保在已连接要素图层的数据面板中启用允许导出。 要在运行时在微件的结果面板中包含导出按钮,请在“周边”微件设置的操作选项卡上打开启用数据操作。
打印报告
您可以使用“打印”微件打印“周边”微件的结果。 要打印“周边”微件的结果,必须将“打印”微件连接到支持报告的自定义打印服务。 有关创建、共享和使用包含报表功能的自定义打印服务的详细信息,请阅读以下资源:
交互选项
如果要素在当前地图范围内或靠近绘制的点、线或面,则“周边”微件可以找到这些要素。 您还可以使用消息和数据操作从“搜索”微件、“表”微件、“添加数据”微件和其他微件获取输入位置。
“周边”微件可以是记录选择更改触发器的目标。 触发器和消息操作可创建 Experience Builder 微件之间的自动交互。 例如,可以将“周边”微件配置为在用户使用“搜索”微件搜索记录时自动查找附近的要素。 同样,您也可以将“周边”微件配置为在用户选择“表格”微件中的要素时自动查找附近的要素。 记录选择更改消息操作在“搜索”、“表格”和其他微件设置的操作选项卡上可用。
查看支持记录选择更改触发器的微件列表。
该微件也可以是设置位置数据操作的目标,您可以在其他微件的设置中打开该操作。 您可以使用此数据操作将设置位置按钮添加到“要素信息”等微件。
查看支持设置位置数据操作的微件列表。
在“周边”微件的操作设置中,支持导出数据操作。 如果打开此数据操作,用户可以在运行时将分析数据导出为 CSV 格式。
如果您在应用程序中添加了方向微件,则“周边”微件将支持计划路径数据操作。 您可以使用“周边”微件的点数据计划包含多个停靠点的路径。
其他资源
以下资源用于在 Experience Builder 中重新创建 ArcGIS Web AppBuilder 工作流: