“周边”微件用于查找和分析定义位置指定距离内的要素。 位置可以为选定要素、绘制的图形或由其他输入方法定义的位置。 您还可以根据当前地图范围查找要素。
该微件可以执行三种类型的分析：查找最接近定义位置的要素，查找定义位置指定距离内的所有要素，并使用统计函数和 SQL 表达式汇总附近要素的数值。
注：
“周边”微件用于替换 ArcGIS Web AppBuilder 周边、态势感知、信息摘要和筛查微件的功能。 此功能大部分现已可用，将在 Experience Builder 的未来版本中逐步添加。
示例
使用此微件可支持以下应用程序设计要求：
- 您希望用户单击地图上的一个点并确定最近的投票位置。
- 您希望用户确定医院一定距离内城镇的总人口。
- 您希望用户确定一个区域中有多少建筑物符合当地的无障碍法规。
用法说明
此微件需要连接到“地图”微件。 “地图”微件必须连接到的数据源必须至少包含一个要素图层。
注：
该微件支持子类型图层组中的单个子类型子图层。
如果数据源有相关数据，并且您在 Map Viewer 的弹出窗口中配置了相关记录，您可以使用 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 工作流：