“周边”微件—ArcGIS Experience Builder

“周边”微件用于查找和分析定义位置指定距离内的要素。位置可以为选定要素、绘制的图形或由其他输入方法定义的位置。您还可以根据当前地图范围查找要素。

该微件可以执行三种类型的分析：查找最接近定义位置的要素，查找定义位置指定距离内的所有要素，并使用统计函数和 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）和数据字段构建更复杂的表达式。
        相交长度总和或相交面积总和 - 选中此框可显示搜索距离缓冲区内要素的总相交长度（对于线要素）或总面积（对于面要素）。当连接的图层是线或面要素图层时，会显示此设置。单击编辑按钮添加标注和格式数字。
        颜色模式 - 指定显示背景颜色的方法，可以是单一颜色，也可以按类别显示。然后选择颜色。添加摘要后将显示此设置。
    以下设置适用于所有三个分析工具：
    - 要素计数 - 在结果中包含要素计数。
    - 在地图上高亮显示结果 - 如果启用此设置，则当用户单击并展开结果列表时，将在地图上高亮显示结果。可以选择高亮显示颜色。
      警告：
      如果图层包含大量要素，则高亮显示结果可能会导致性能问题。
    - 展开分析结果 - 指定默认情况下是展开还是折叠结果列表。
      - 展开要素详细信息 - 对于邻域，默认情况下选中此框可展开结果列表中各个要素的详细信息。
        警告：
        如果图层包含大量要素，则展开所有详细信息并高亮显示结果可能会导致性能问题。
    - 返回相交的面 - 如果启用此设置，则与输入位置相交的面将包含在结果中。
    - 配置导出字段 - 选择用户使用导出数据操作导出结果时，要包含的字段。
    - 包含近似距离 - 对于最近要素和邻域分析，启用此设置可在已导出文件中添加近似距离字段。
  - 显示要素计数 - 可选择显示每个分析工具的要素计数。
  - 显示分析图标 - 可选择显示分析工具图标。
    提示：
    当在多个分析中多次使用同一图层时，这些图标将非常有用。
- 结果 - 配置与分析结果在运行时的显示方式有关的设置。
  - 分析图标 - 在结果中包含每个分析工具名称旁的图标。
  - 地图符号 - 包含表示满足分析条件的要素符号系统的地图符号。
    注：
    如果地图图层通过属性字段进行符号化，并且打开分组要素，则微件将使用该字段作为默认分组字段。
  - 近似距离 - 包含指示已找到要素距离输入位置的近似距离的距离值。显示的单位为在距离单位下设置的单位，或用户在运行时选取的单位。
  - 过滤图层以仅显示结果 - 过滤图层以仅显示满足分析条件的要素。
  - 显示所有图层结果，无论可见性如何 - 如果您使用隐藏图层（在地图中关闭可见性的图层）配置“周边”微件，并且希望在微件找到这些图层的结果时打开这些图层的可见性，请打开此设置。
    “周边”微件结果始终包含符合您使用该微件配置的所有图层（可见或不可见）的分析条件的要素。但是，如果某些要素位于隐藏图层中，则它们可能会出现在结果中，但不会出现在地图上，这可能会让最终用户感到困惑。如果打开此设置，所有结果要素都会出现在地图上，因为微件会打开任何具有结果要素的隐藏图层的图层可见性。
  - 启用邻域搜索 - 打开此设置可允许用户将单个结果用作分析的新输入位置。此设置允许“周边”微件同时作为设置位置数据操作的触发器和目标，您可以在微件设置的操作选项卡上配置该操作。
  - 保存输入位置 - 可以将分析的输入位置另存为地图图层中的要素。为此，您必须指定点、折线或面图层，并且该图层必须可编辑。在运行时，可以在保存要素之前输入其属性。
  - 保存搜索区域 - 可以将搜索区域另存为地图的面图层中的要素。为此，您必须指定面图层，并且该图层必须可编辑。在运行时，可以在保存要素之前输入其属性。
常规设置 - 配置以下常规设置：
- 草图颜色 - 定义使用微件的草图工具绘制的点、线和面的颜色。
- 搜索区域符号 - 定义搜索区域面符号的填充颜色、填充透明度、边框颜色和边框粗细。
- 关闭时保留结果 - 启用此选项后，关闭或隐藏微件时将不会清除结果。此选项支持布局配置，其中微件放置在不同的页面上、窗口内或者“微件控制器”微件、“侧边栏”微件、“手风琴”微件或“部分”微件视图中。
- 未找到结果消息 - 自定义未找到任何要素时显示在微件中的文本。您可以更改文本的字体、笔划、颜色和大小（以像素 (px) 为单位）。
- 自定义欢迎消息 - 自定义首次加载微件时显示的文本。可以使用此文本来提供说明。当用户运行分析后，此文本将消失。

允许导出

“周边”微件可以将结果导出为 ArcGIS 项目以及导出到 .pdf、.csv、.json、.geojson、.shp、.fgdb 和 .kml 文件。要允许用户导出结果，请确保在已连接要素图层的数据面板中启用允许导出。要在运行时在微件的结果面板中包含导出按钮，请在“周边”微件设置的操作选项卡上打开启用数据操作。

注：

如果仅启用 .kml、.shp 或 .fgdb 文件导出，而未启用 ArcGIS 项目导出，则不会显示导出按钮。 “周边”微件创建的输出数据源为要素集合图层，这些图层没有关联的 URL 或 REST 端点，因此要启用导出至 KML、shapefile 或地理数据库，您还必须启用导出至 ArcGIS 项目。

当导出至 PDF 时，可以从下拉菜单中选择模板并输入标题。可以在 PDF 报告中包含地图图例。如果配置群组和子群组，则可以合并 PDF 报告中群组和子群组的行。以下是 PDF 导出中显示的其他元素的列表：

当在已连接的“地图”微件的设置中打开比例尺和指南针工具时，将显示比例尺和指北针。
地图上将显示地图属性。
当按位置进行搜索时，将显示感兴趣区域维度的标注。
将显示导出的日期和时间。两者均可编辑。

当您将邻域或汇总分析的结果导出为 .csv 格式时，微件会导出两个 .csv 文件。其中一个包括要素属性，另一个包括参与邻域或汇总分析的要素的数量。

了解有关 Experience Builder 导出设置的详细信息

打印报告

您可以使用“打印”微件打印“周边”微件的结果。要打印“周边”微件的结果，必须将“打印”微件连接到支持报告的自定义打印服务。有关创建、共享和使用包含报表功能的自定义打印服务的详细信息，请阅读以下资源：

如果您无需高级报告功能，希望获得更好的性能，并且无需自定义打印布局，则使用导出数据操作导出至 .pdf 文件是生成报告的最简单方法。文件包含标题、地图、图例和“周边”微件分析结果。此外，如果关闭图层的允许导出，则该图层中的数据将不会显示在 PDF 导出中。

交互选项

如果要素在当前地图范围内或靠近绘制的点、线或面，则“周边”微件可以找到这些要素。您还可以使用消息和数据操作从“搜索”微件、“表”微件、“添加数据”微件、“地图”微件和其他微件获取输入位置。

“周边”微件可以是记录选择更改触发器的目标。触发器和消息操作可创建 Experience Builder 微件之间的自动交互。例如，可以将“周边”微件配置为在用户使用“搜索”微件搜索记录时自动查找附近的要素。同样，您也可以将“周边”微件配置为在用户选择“表格”微件中的要素时自动查找附近的要素。记录选择更改消息操作在“搜索”、“表格”和其他微件设置的操作选项卡上可用。

查看支持记录选择更改触发器的微件列表。

“周边”微件可以是位置更改触发器的目标，这可在地图微件设置中进行配置。当用户使用“地图”微件的定位工具检索当前位置时，将触发触发器。要将当前位置用作“周边”微件的输入位置，在“地图”微件设置中添加位置更改触发器，选择“周边”微件作为目标，然后选择设置位置消息操作。

“周边”微件也可以是设置位置数据操作的目标，您可以在其他微件的设置和“周边”微件的设置中打开该操作。您可以使用此数据操作将设置位置按钮添加到“要素信息”等微件。还可以使用此数据操作来允许用户将一个分析的结果用作另一个分析的输入位置。为此，请打开启用邻近搜索设置。

查看支持设置位置数据操作的微件列表。

在“周边”微件的操作设置中，支持导出数据操作。如果打开此数据操作，用户可以在运行时将分析数据导出为 CSV 格式。

如果您在应用程序中添加了方向微件，则“周边”微件将支持计划路径数据操作。您可以使用“周边”微件的点数据计划包含多个停靠点的路径。

其他资源

以下资源用于在 Experience Builder 中重新创建 ArcGIS Web AppBuilder 工作流：

有关此主题的反馈?

注：

示例

用法说明

注：

设置

注：

注：

警告：

警告：

提示：

注：

允许导出

注：

打印报告

交互选项

其他资源

在本主题中