Available with Location Referencing license.
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 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 and Version Management capabilities enabled.
To create an LRS and publish a feature service with the Linear Referencing and Version Management capabilities enabled, follow the steps in 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 From Measure and To Measure values to search for a specific part of the route.
- 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.
- Network—The network layer that is used to search for routes.
- 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 the input LRS network is configured with a multi-field route ID, the concatenated route ID appears.
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, and Referent.
- 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 the 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.
- Search—Set a search radius.
- Spatial Reference—Set a spatial reference for the search. You can use the spatial reference from the map or from the LRS layers.
- Results—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.
- 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 setting from the widget panel.
- Hide Network—Hide the Network setting from the widget panel.
- 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.
- Open Experience Builder. Sign in to an ArcGIS Enterprise portal.
Note:
Your ArcGIS Enterprise account must be licensed for Location Referencing.
- Add a Map widget. Connect it to a web map with LRS data published with the Linear Referencing and Version Management capabilities 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 route name configured as an identifier, this setting is labeled Route Name.
Note:
If an LRS network is configured with a multi field route ID, then 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. - Optionally, provide a measure value, multiple measure values, or starting and ending measure values to search for specific locations along the route.
- 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, then 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.
- Open Experience Builder. Sign in to an ArcGIS Enterprise portal.
Note:
Your ArcGIS Enterprise account must be licensed for Location Referencing.
- Add a Map widget. Connect it to a web map with LRS data published with the Linear Referencing and Version Management capabilities 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 the 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, then 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.
- Open Experience Builder. Sign in to an ArcGIS Enterprise portal.
Note:
Your ArcGIS Enterprise account must be licensed for Location Referencing.
- Add a Map widget. Connect it to a web map with LRS data published with the Linear Referencing and Version Management capabilities 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, then you can select a record in the results pane to make the map highlight and zoom to that route.
Interaction options
This widget supports data actions, which you can turn on in 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.