The Search By Route widget allows you to search for a route or portion of a route and locate specific locations along it in a Linear Referencing System (LRS). You can use the widget to manage pipeline data with ArcGIS Pipeline Referencing and roadways data with ArcGIS Roads and Highways. You can find a route and zoom to a specific measure location using a variety of search methods. You can also use returned routes and locations in editing workflows with the Add Point Event and Add Line Event widgets.
Examples
Use this widget to support app design requirements such as the following:
- You want to find the locations of specific measures along routes.
- You want to find multiple locations of specific measures along routes.
- Your organization needs users to be able to orient themselves along a route while performing LRS event editing and analysis tasks.
Usage notes
This widget requires connection to a Map widget. To search by routes, the Map widget must be connected to a web map data source published with an LRS with the Linear Referencing capability enabled. To view versions other than the default version, the web map data source must be published with an LRS with the Version Management capability enabled.
To create an LRS and publish a feature service with the Linear Referencing and Version Management capabilities enabled, follow the steps in the ArcGIS Pro documentation:
- Pipeline Referencing—Create an LRS and share an LRS as web layers
- Roads and Highways—Create an LRS and share an LRS as web layers
When you include this widget in an app, the widget panel provides users with the following options for searching for routes:
- Method—Choose a search method.
- Route and Measure—Search by route ID. Optionally, you can also provide a measure value, multiple measure values, or a range of measure values by providing a single measure, multiple measures, or a measure range.
- Route ID or Route Name—Provide a route ID or name for the route you want to search. If the network layer has route name configured as an identifier, this setting is labeled Route Name.
Note:
If an LRS network is configured with a multifield route ID, the fields that form the concatenated route ID appear. In this case, provide valid values for all route ID fields to search for a route.
- Route ID or Route Name—Provide a route ID or name for the route you want to search. If the network layer has route name configured as an identifier, this setting is labeled Route Name.
- Coordinate—Search by coordinates. Provide x-, y-, and, optionally, z-coordinates.
- Referent—Search by referent event. A referent is a fixed location along a route that has a discrete measure value from which other locations are determined.
- Referent—Choose the referent event that you intend to use for the search.
- Referent Field—Provide a value for the identifier event referent field. This field is used to search for individual event features.
- Offset—Optionally, provide an offset value. The offset is a fixed distance from a referent event; it can be positive or negative.
- Line and Measure—Search by line ID. Optionally, you can also provide a measure value, multiple measure values, or a measure range to search along the line.
- Line ID or Line Name—Provide a line ID or name for the route you want to search.
- Route and Measure—Search by route ID. Optionally, you can also provide a measure value, multiple measure values, or a range of measure values by providing a single measure, multiple measures, or a measure range.
- Network—The network layer that is used to search for routes.
Settings
The Search By Route widget includes the following settings:
- Select a Map widget—Select a Map widget.
- Load Layers—Load layers from the web maps in the connected Map widget. To load layers, the Map widget must be connected to a web map with LRS layers.
- Clear Layers—Remove all loaded layers from the widget.
- Layer Configuration—Click a layer to open the Layer Configuration panel.
- Label—Provide a meaningful label for the layer. This label appears in the widget panel at run time.
- Search methods—Choose a Default search method that you want selected when the widget first loads, and choose which search methods are available at run time. You must turn on at least one: Route and Measure, Coordinate, Referent, and Line and Measure.
- Search measures—These settings appear when you choose the Route and Measure search method. Choose which types of measure values users can search at run time. You must turn on at least one of the following options:
- Single—Allow users to search for single measure values along routes.
- Multiple—Allow users to search for multiple measure values along routes.
- Range—Allow users to search for a range of measure values along routes.
- Identifier—Configure the LRS network fields that will be used to search for routes. You can drag the fields to change their order and deselect fields to make them not appear in the widget panel at run time. For the default, choose one of the following options:
- Route ID—The route ID field that will be used to search for routes.
- Multi field route ID—Fields that form the concatenated route ID will be used to search for routes. Drag the fields to change the order and deselect the fields to not display them in the widget.
- Route Name—The route name field that will be used to search for routes.
- Line ID—The line ID field that will be used to search for routes in a line network.
- Line Name—The line name field that will be used to search for routes in a line network.
- Spatial Reference—Set a spatial reference for the search. You can use the spatial reference from the map or from the LRS layers.
- Search—Set a search radius.
- Results—Use the following settings to define how the widget displays search results.
- Sort results by—Add fields to sort results by field. You can make results sort in ascending or descending order.
- Expand by default—Turn on this setting to make search results expand by default when the user performs a search.
- Advanced field display—Choose whether to show or hide each network attribute field in search results. If a line network has an associated derived network, then you can also choose to show or hide the attribute fields of that derived network in search results.
- Selection settings—Customize how routes appear when you search for them and select them.
- Highlight—Choose a display color for the selection highlight. The default color is cyan (#00FFFF).
- Width—Set the width of the selection highlight in pixels. The default width is 3.
- Label color—Set the color for the route label. The default color is black (#000000).
- Label size—Set the font size of the route label in points. The default size is 12.
- Result settings—Configure the page size for search results, meaning the number of results that display per page. The default is 25 records.
- Display settings—Choose which settings to display in the widget panel at run time and configure default settings that you want available in the widget when it first loads.
- Hide Method—Hide the Method parameter from the widget panel.
- Hide Network—Hide the Network parameter from the widget panel.
- Hide Route in Search by Line—Hide the route ID or route name from the widget panel when searching by line.
- Default network—Choose the default network layer for searching for routes.
- Default referent—Choose the default referent event for searching by referent.
- Default Offset Units—Choose the default referent event offset units for searching by referent.
Search for routes by name or ID
Complete the following steps to search by route:
- Start Experience Builder. Sign in to an ArcGIS Enterprise portal.
- Add a Map widget. Connect it to a web map with LRS data published with the Linear Referencing capability enabled and, optionally, the Version Management capability enabled.
- Add a Search By Route widget. Connect it to the Map widget, then load the LRS layers from the map widget.
- If there are multiple methods configured in the widget settings, choose Route and Measure from the drop-down menu.
- If there are multiple networks configured in the widget settings, choose a network from the Network drop-down menu.
- Provide a route ID or name in the Route ID or Route Name text box.
If the network layer has a route name configured as an identifier, this setting is labeled Route Name.
Note:
If an LRS network is configured with a multifield route ID, the fields that form the concatenated route ID appear. In this case, provide valid values for all route ID fields to search for a route.Note:
You can use wildcard characters to search for routes. Wildcards are special characters that can stand in for unknown characters in a search value. The following characters are supported:
Character Description %
Represents any number of characters.
_
Represents one character.
- Optionally, provide a measure value, multiple measure values, or starting and ending measure values to search for specific locations along the route.
Note:
Station values are also supported as input measure values. - Click Search.
If a valid route exists that fits the search parameters, it appears in the results pane. If only one result exists that fits the search parameters, the map highlights and zooms to that route. If more than one result exists that fits the search parameters, you can select a record in the results pane to make the map highlight and zoom to that route.
Search for routes by coordinate
Complete the following steps to search by coordinate:
- Start Experience Builder. Sign in to an ArcGIS Enterprise portal.
- Add a Map widget. Connect it to a web map with LRS data published with the Linear Referencing capability enabled and, optionally, the Version Management capability enabled.
- Add a Search By Route widget. Connect it to the Map widget, then load the LRS layers from the map widget.
- If there are multiple methods configured in the widget settings, choose Coordinate from the Method drop-down menu.
- If there are multiple networks configured in the widget settings, choose a network from the Network drop-down menu.
- Provide values in the X Coordinate and Y Coordinate text boxes. Optionally, provide a value in the Z Coordinate text box.
- Click Search.
If a valid route exists that fits the search parameters, it appears in the results pane. If only one result exists that fits the search parameters, the map highlights and zooms to that route. If more than one result exists that fits the search parameters, you can select a record in the results pane to make the map highlight and zoom to that route.
Search for routes by referent
Complete the following steps to search by referent:
- Start Experience Builder. Sign in to an ArcGIS Enterprise portal.
- Add a Map widget. Connect it to a web map with LRS data published with the Linear Referencing capability enabled and, optionally, the Version Management capability enabled.
- Add a Search By Route widget. Connect it to the Map widget, then load the LRS layers from the map widget.
- If there are multiple methods configured in the widget settings, choose Referent from the Method drop-down menu.
- If there are multiple networks configured in the widget settings, choose a network from the Network drop-down menu.
- Click the Referent drop-down arrow and choose a referent layer. You can use any point event layer from the map as a referent layer.
- Provide a value in the Referent Field text box. You can use any field with unique values from the referent layer as a referent field.
- Optionally, provide an offset value in the Offset text box.
- Click Search.
If a valid route exists that fits the search parameters, it appears in the results pane. If only one result exists that fits the search parameters, the map highlights and zooms to that route. If more than one result exists that fits the search parameters, you can select a record in the results pane to make the map highlight and zoom to that route.
Search for routes by line name or ID
Complete the following steps to search by line:
- Start Experience Builder. Sign in to an ArcGIS Enterprise portal.
- Add a Map widget. Connect it to a web map with LRS data published with the Linear Referencing capability enabled and, optionally, the Version Management capability enabled.
- Add a Search By Route widget. Connect it to the Map widget, then load the LRS layers from the map widget.
- If there are multiple methods configured in the widget settings, choose Line and Measure from the drop-down menu.
- If there are multiple networks configured in the widget settings, choose a line network from the Network drop-down menu.
- Provide a line ID or name in the Line ID or Line Name text box.
Note:
You can use wildcard characters to search for lines. Wildcards are special characters that can stand in for unknown characters in a search value. The following characters are supported:
Character Description %
Represents any number of characters.
_
Represents one character.
- Optionally, provide a measure value, multiple measure values, or starting and ending measure values to search for specific locations along the line.
Note:
Station values are also supported as input measure values. - Click Search.
If a valid line exists that fits the search parameters, it appears in the results pane. If only one result exists that fits the search parameters, the map highlights and zooms to that route. If more than one result exists that fits the search parameters, you can select a record in the results pane to make the map highlight and zoom to that line.
Interaction options
This widget supports data actions, which you can enable on the Action tab of widgets' settings.
You can use data actions in the Search By Route widget to launch the Add Point Event widget or Add Line Event widget and populate values. To do this, you must turn on the Add Point Event and Add Line Event data actions in the Search By Route widget's settings.
The Search By Route widget's Add Point Event and Add Line Event data actions can populate the route and measure parameters in the Add Point Event and Add Line Event widgets.