按路径搜索微件—ArcGIS Experience Builder

“按路径搜索”微件可用于在线性参照系统 (LRS) 中搜索路径或路径的一部分，并定位沿线的具体位置。您可以使用微件，通过 ArcGIS Pipeline Referencing 管理管道数据，使用 ArcGIS Roads and Highways 管理道路数据。您可以使用各种搜索方法查找路径并放大到特定的测量位置。您还可以在编辑工作流程中使用“添加点事件”和“添加线事件”微件来使用返回的路径和位置。

示例

使用此微件可支持以下应用程序设计要求：

您想找到沿线特定测量的位置。
您想找到沿线特定测量的多个位置。
您的组织需要用户在执行 LRS 事件编辑和分析任务时，能够沿着路径确定方向。

用法说明

此微件需要连接到“地图”微件。要按照路径搜索，“地图”微件必须连接到 Web 地图数据源，该数据源在发布时应使用启用线性参考功能的 LRS。要查看默认版本以外的版本，Web 地图数据源在发布时必须使用启用版本管理功能的 LRS。

要创建 LRS 并发布启用了线性参考和版本管理功能的要素服务，请按照 ArcGIS Pro 文档中的步骤操作：

Pipeline Referencing - 创建 LRS 并将 LRS 作为网络层共享
Roads and Highways - 创建 LRS 并将 LRS 作为网络层共享

当您在应用程序中包含此微件时，微件面板会为用户提供以下搜索路径的选项：

方法 - 选择一个搜索方法。
- 路径和测量 - 按路径 ID 搜索。您还可以提供单个测量值、多个测量值或测量值范围，以便搜索路径。
  - 路径 ID 或路径名称 - 为要搜索的路径提供路径 ID 或名称。如果网络图层已将 route name 配置为标识符，则此设置将标为路径名称。
    注：
    如果 LRS 网络配置了多字段路径 ID，则会显示构成串连路径 ID 的字段。在这种情况下，请为所有路径 ID 字段提供有效值，以搜索路径。
- 坐标 - 按照坐标搜索。请提供 x、y 和 z（可选）坐标。
- 参考 - 按照参考事件搜索。参考即沿路径的固定位置，具有离散测量值，可根据该值确定其他位置。
  - 参考 - 选择您打算用于搜索的参考事件。
  - 参考字段 - 为标识符事件参考字段提供一个值。此字段用于搜索单个事件要素。
  - 偏移 - 可选择提供一个偏移值。偏移是与参考事件之间的固定距离；它可以是正数或负数。
- 网络 - 用于搜索路径的网络层。

设置

“按路径搜索”微件包含以下设置：

选择“地图”微件 - 选择“地图”微件。
加载图层 - 在连接的地图微件中从 web 地图加载图层。要加载图层，地图微件必须连接到带有 LRS 图层的 web 地图。
清除图层 - 从微件中移除所有已加载的图层。
图层配置 - 单击图层打开图层配置面板。
- 标注 - 为图层提供一个有意义的标注。运行时，该标签会显示在微件面板中。
- 搜索方法 - 选择一个想在微件首次加载时选择的默认搜索方法，并选择运行时可用的搜索方法。您必须打开至少一个选项：路径和测量、坐标和参考。
- 搜索测量值 - 选择路径和测量搜索方法时会显示这些设置。选择用户可在运行时搜索的测量值类型。您必须至少开启以下选项之一：
  - 单个 - 允许用户沿路搜索单个测量值。
  - 多个 - 允许用户沿路搜索多个测量值。
  - 范围 - 允许用户沿路搜索测量值范围。
- 标识符 - 配置用于搜索路径的 LRS 网络字段。您可以拖动字段来更改它们的顺序，也可以取消选择字段，使它们在运行时不显示在微件面板中。选择以下选项之一作为默认设置：
  - 路径 ID - 用于搜索路径的路径 ID 字段。
  - 多字段路径 ID - 构成连接路径 ID 的字段将用于搜索路径。拖动字段可更改顺序，取消选择字段则字段不会在微件中显示。
- 空间参考 - 设置搜索的空间参考。您可以使用地图或 LRS 图层中的空间参考。
- 搜索 - 设置搜索半径。
- 结果 - 添加字段，按字段对结果进行排序。您可以按升序或降序对结果进行排序。
  - 默认展开 - 打开此设置可使搜索结果在用户执行搜索时默认展开。
选择设置 - 自定义搜索和选择路径时的显示方式。
- 高亮显示 - 为选择项突出显示选择一种显示颜色。默认颜色为青色 (#00FFFF)。
- 宽度 - 以像素为单位设置选择项突出显示的宽度。默认宽度为 3。
- 标注颜色 - 设置路径标注的颜色。默认颜色是黑色 (#000000)。
- 标注大小 - 以点的形式设置路径标注的字体大小。默认大小为 12。
结果设置 - 配置搜索结果的页面大小，即每页显示的结果数量。默认值为 25 个记录。
显示设置 - 选择要在运行时显示在微件面板中的设置，并配置希望在微件首次加载时可用的默认设置。
- 隐藏方法 - 从微件面板中隐藏方法参数。
- 隐藏网络 - 从微件面板中隐藏网络参数。
- 默认网络 - 选择搜索路径的默认网络图层。
- 默认参考 - 选择默认参考事件，以便按参考进行搜索。
- 默认偏移单位 - 选择默认参考事件偏移单位，以便按参考进行搜索。

按名字或 ID 搜索路径。

要按路径搜索，请完成以下步骤：

启动 Experience Builder。登录到 ArcGIS Enterprise 门户。
添加地图微件。将其连接到包含 LRS 数据的 Web 地图，该数据在发布时需已启用线性参考功能和版本管理功能（可选）。
了解更多有关启动 Pipeline Referencing 的 ArcGIS Pro 功能的信息
了解更多有关启动 Roads and Highways 的 ArcGIS Pro 功能的信息
添加“按路径搜索”微件。将其连接到地图微件，然后从地图微件加载 LRS 图层。
如果微件设置中配置了多种方法，请从下拉菜单中选择路径和测量。
如果微件设置中配置了多种网络，请从网络下拉菜单中选择一个网络。
在路径 ID 或路径名称文本框中提供路径 ID 或名称。
如果网络图层已将路径名称配置为标识符，则此设置将标注为路径名称。
注：
如果 LRS 网络配置了多字段路径 ID，则会显示构成串连路径 ID 的字段。在这种情况下，请为所有路径 ID 字段提供有效值，以搜索路径。
注：
可以使用通配符搜索路径。通配符是可以代替搜索值中未知字符的特殊字符。支持以下字符：
字符描述
%
表示任意数量的字符。
_
表示一个字符。
可选择提供一个测量值、多个测量值或起始测量值和结束测量值，以沿路搜索特定的位置。
注：
也支持使用定点值作为输入测量值。
单击搜索。
如果存在符合搜索参数的有效路径，则路径会显示在结果窗格中。如果只有一个结果符合搜索参数，则地图会突出显示并缩放到该路径。如果符合搜索参数的结果不止一个，那么您可以在结果窗格中选择一条记录，使地图突出显示并缩放至该路径。

字符	描述
%	表示任意数量的字符。
_	表示一个字符。

按坐标搜索路径。

要按坐标搜索，请完成以下步骤：

启动 Experience Builder。登录到 ArcGIS Enterprise 门户。
添加地图微件。将其连接到包含 LRS 数据的 Web 地图，该数据在发布时需已启用线性参考功能和版本管理功能（可选）。
了解更多有关启动 Pipeline Referencing 的 ArcGIS Pro 功能的信息
了解更多有关启动 Roads and Highways 的 ArcGIS Pro 功能的信息
添加“按路径搜索”微件。将其连接到地图微件，然后从地图微件加载 LRS 图层。
如果微件设置中配置了多种方法，请从方法下拉菜单中选择坐标。
如果微件设置中配置了多种网络，请从网络下拉菜单中选择一个网络。
在 X 坐标和 Y 坐标文本框中提供值。或者，可以在 Z 坐标文本框中提供值。
单击搜索。
如果存在符合搜索参数的有效路径，则路径会显示在结果窗格中。如果只有一个结果符合搜索参数，则地图会突出显示并缩放到该路径。如果符合搜索参数的结果不止一个，那么您可以在结果窗格中选择一条记录，使地图突出显示并缩放至该路径。

按参考搜索路径

请完成以下步骤以按参考搜索：

启动 Experience Builder。登录到 ArcGIS Enterprise 门户。
添加地图微件。将其连接到包含 LRS 数据的 Web 地图，该数据在发布时需已启用线性参考功能和版本管理功能（可选）。
了解更多有关启动 Pipeline Referencing 的 ArcGIS Pro 功能的信息
了解更多有关启动 Roads and Highways 的 ArcGIS Pro 功能的信息
添加“按路径搜索”微件。将其连接到地图微件，然后从地图微件加载 LRS 图层。
如果微件设置中配置了多种方法，请从方法下拉菜单中选择参考。
如果微件设置中配置了多种网络，请从网络下拉菜单中选择一个网络。
单击参考下拉箭头，选择一个参考图层。您可以使用地图上的任何点事件图层作为参考图层。
在参考字段文本框中提供值。您可以将参考图层中具有唯一值的任何字段用作参考字段。
还可以选择在偏移文本框中提供偏移值。
单击搜索。
如果存在符合搜索参数的有效路径，则路径会显示在结果窗格中。如果只有一个结果符合搜索参数，则地图会突出显示并缩放到该路径。如果符合搜索参数的结果不止一个，那么您可以在结果窗格中选择一条记录，使地图突出显示并缩放至该路径。