Show / Hide Table of Contents

Method SuggestAsync

SuggestAsync(String)

Retrieves a list of possible address variants for a given partial address.

Declaration
public Task<IReadOnlyList<SuggestResult>> SuggestAsync(string searchText)
Parameters
Type Name Description
String searchText

The partial address for which to get suggestions.

Returns
Type Description
Task<IReadOnlyList<SuggestResult>>

A task that represents the asynchronous suggestion operation. The value of the task result contains a read-only collection of SuggestResult objects.

Remarks

Geocoding suggestions provide a mechanism for implementing character-by-character auto-complete. Using a text input and optional SuggestParameters, suggested addresses can be quickly found and presented to the user. Suggestions are not limited to addresses, they can also be used for POIs (Points of Interest). To return a focused set of suggestions, set the PreferredSearchLocation or the SearchArea. Using the PreferredSearchLocation is similar to how ArcGIS Pro limits the suggestions returned.

Applies to

Platforms and versions
TargetVersions
.NET Standard 2.0100.3 - 200.0
.NET 6.0100.13 - 200.0
.NET 6.0 Windows100.13 - 200.0
.NET 6.0 Android200
.NET 6.0 iOS200
.NET Framework100.0 - 200.0
.NET 5100.10 - 100.12
.NET Core 3.1100.7 - 100.12
Android100.0 - 100.15
iOS100.0 - 100.15
UWP100.0 - 200.0
Relevant samples
Find address: Find the location for an address.

SuggestAsync(String, CancellationToken)

Retrieves a list of possible address variants for a given partial address and set of search parameters.

Declaration
public Task<IReadOnlyList<SuggestResult>> SuggestAsync(string searchText, CancellationToken cancellationToken)
Parameters
Type Name Description
String searchText

The partial address for which to get suggestions.

CancellationToken cancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns
Type Description
Task<IReadOnlyList<SuggestResult>>

A task that represents the asynchronous suggestion operation. The value of the task result contains a read-only collection of SuggestResult objects.

Remarks

Geocoding suggestions provide a mechanism for implementing character-by-character auto-complete. Using a text input and optional SuggestParameters, suggested addresses can be quickly found and presented to the user. Suggestions are not limited to addresses, they can also be used for POIs (Points of Interest). To return a focused set of suggestions, set the PreferredSearchLocation or the SearchArea. Using the PreferredSearchLocation is similar to how ArcGIS Pro limits the suggestions returned.

Applies to

Platforms and versions
TargetVersions
.NET Standard 2.0100.3 - 200.0
.NET 6.0100.13 - 200.0
.NET 6.0 Windows100.13 - 200.0
.NET 6.0 iOS200
.NET Framework100.0 - 200.0
.NET 5100.10 - 100.12
.NET Core 3.1100.7 - 100.12
Android100.0 - 100.14
iOS100.0 - 100.15
UWP100.0 - 200.0

SuggestAsync(String, SuggestParameters)

Retrieves a list of possible address variants for a given partial address and set of search parameters.

Declaration
public Task<IReadOnlyList<SuggestResult>> SuggestAsync(string searchText, SuggestParameters parameters)
Parameters
Type Name Description
String searchText

The partial address for which to get suggestions.

SuggestParameters parameters

Additional search parameters for the suggestion operation.

Returns
Type Description
Task<IReadOnlyList<SuggestResult>>

A task that represents the asynchronous suggestion operation. The value of the task result contains a read-only collection of SuggestResult objects.

Remarks

Geocoding suggestions provide a mechanism for implementing character-by-character auto-complete. Using a text input and optional SuggestParameters, suggested addresses can be quickly found and presented to the user. Suggestions are not limited to addresses, they can also be used for POIs (Points of Interest). To return a focused set of suggestions, set the PreferredSearchLocation or the SearchArea. Using the PreferredSearchLocation is similar to how ArcGIS Pro limits the suggestions returned.

Applies to

Platforms and versions
TargetVersions
.NET Standard 2.0100.3 - 200.0
.NET 6.0100.13 - 200.0
.NET 6.0 Windows100.13 - 200.0
.NET 6.0 Android200
.NET 6.0 iOS200
.NET Framework100.0 - 200.0
.NET 5100.10 - 100.12
.NET Core 3.1100.7 - 100.12
Android100.0 - 100.15
iOS100.0 - 100.15
UWP100.0 - 200.0
Relevant samples
Find place: Find places of interest near a location or within a specific area.

SuggestAsync(String, SuggestParameters, CancellationToken)

Retrieves a list of possible address variants for a given partial address and set of search parameters.

Declaration
public Task<IReadOnlyList<SuggestResult>> SuggestAsync(string searchText, SuggestParameters parameters, CancellationToken cancellationToken)
Parameters
Type Name Description
String searchText

Part of address text.

SuggestParameters parameters

Suggest method parameters.

CancellationToken cancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Returns
Type Description
Task<IReadOnlyList<SuggestResult>>

A task that represents the asynchronous suggestion operation. The value of the task result contains a read-only collection of SuggestResult objects.

Remarks

Geocoding suggestions provide a mechanism for implementing character-by-character auto-complete. Using a text input and optional SuggestParameters, suggested addresses can be quickly found and presented to the user. Suggestions are not limited to addresses, they can also be used for POIs (Points of Interest). To return a focused set of suggestions, set the PreferredSearchLocation or the SearchArea. Using the PreferredSearchLocation is similar to how ArcGIS Pro limits the suggestions returned.

Applies to

Platforms and versions
TargetVersions
.NET Standard 2.0100.3 - 200.0
.NET 6.0100.13 - 200.0
.NET 6.0 Windows100.13 - 200.0
.NET 6.0 iOS200
.NET Framework100.0 - 200.0
.NET 5100.10 - 100.12
.NET Core 3.1100.7 - 100.12
Android100.0 - 100.14
iOS100.0 - 100.15
UWP100.0 - 200.0
In This Article
Back to top Copyright © 2022 Esri.