Skip to content

Latest commit

 

History

History
67 lines (50 loc) · 2.94 KB

search-view.md

File metadata and controls

67 lines (50 loc) · 2.94 KB
Raw

Search View

Search View enables searching using one or more locators, with support for suggestions, automatic zooming, and custom search sources.

image

NOTE: Search View uses metered ArcGIS services by default, so you will need to configure an API key. See Security and authentication documentation for more information.

Features

  • Updates search suggestions as you type
  • Supports using the Esri world geocoder or any other ArcGIS locators
  • Supports searching using custom search sources
  • Supports searching multiple sources simultaneously
  • Allows for customization of the display of search results
  • Allows you to repeat a search within a defined area, and shows a button to enable that search when the view's viewpoint changes
  • Separates the behavior (SearchViewModel) and the display (SearchView) to allow you to create a custom UI if needed

Customization

The following properties enable customization of the view:

  • EnableAutomaticConfiguration - Controls whether view is automatically configured for the attached GeoView's map or scene. By default, this will set up a single World Geocoder search source. In future releases, this behavior may be extended to support other web map configuration options.
  • EnableRepeatSearchHereButton - Controls whether a 'Repeat Search Here' button is shown when the user navigates the attached GeoView after a search is completed.
  • EnableResultListView - Controls whether a result list is displayed.
  • EnableIndividualResultDisplay - Controls whether the result list is shown when there is only one result.
  • MutlipleResultZoomBuffer - Controls the buffer distance around collection results when a GeoView is attached and a search has multiple results.

Usage

.NET MAUI:

SearchView shows results in a list on top of underlying content, so it is best to position the view near the top of the page, on top of the MapView or SceneView.

<Grid xmlns:esri="http://schemas.esri.com/arcgis/runtime/2013"
      RowDefinitions="32,Auto,*"
      RowSpacing="0">
    <esri:SearchView Grid.RowSpan="2"
                     GeoView="{Binding Source={Reference MyMapView}}" />
    <esri:MapView x:Name="MyMapView"
                  Grid.Row="1"
                  Grid.RowSpan="2" />
</Grid>

UWP/WinUI:

<Grid xmlns:esri="using:Esri.ArcGISRuntime.UI.Controls"
      xmlns:toolkit="using:Esri.ArcGISRuntime.Toolkit.UI.Controls">
    <esri:MapView x:Name="MyMapView" />
    <toolkit:SearchView Margin="4"
                        GeoView="{x:Bind MyMapView}" />
</Grid>

WPF:

<Grid xmlns:esri="http://schemas.esri.com/arcgis/runtime/2013">
    <esri:MapView x:Name="MyMapView" />
    <esri:SearchView Margin="4"
                     GeoView="{Binding ElementName=MyMapView}" />
</Grid>