select

open fun select(suggestion: SearchSuggestion, callback: SearchSelectionCallback): AsyncOperationTask

The second step of forward geocoding. Call this function to get a SearchResult (with coordinates) from a SearchSuggestion.

Return

AsyncOperationTask object representing pending completion of the request.

Parameters

suggestion

Search suggestion to resolve and get the final result with address and coordinates.

callback

The callback to retrieve SearchResult with resolved coordinates. Events are dispatched on the main thread.


open fun select(suggestion: SearchSuggestion, options: SelectOptions, callback: SearchSelectionCallback): AsyncOperationTask

The second step of forward geocoding. Call this function to get a SearchResult (with coordinates) from a SearchSuggestion.

Return

AsyncOperationTask object representing pending completion of the request.

Parameters

suggestion

Search suggestion to resolve and get the final result with address and coordinates.

options

Options used for controlling internal "select" operation logic.

callback

The callback to retrieve SearchResult with resolved coordinates.


abstract fun select(suggestion: SearchSuggestion, options: SelectOptions, executor: Executor, callback: SearchSelectionCallback): AsyncOperationTask

The second step of forward geocoding. Call this function to get a SearchResult (with coordinates) from a SearchSuggestion.

Return

AsyncOperationTask object representing pending completion of the request.

Parameters

suggestion

Search suggestion to resolve and get the final result with address and coordinates.

options

Options used for controlling internal "select" operation logic.

executor

Executor used for events dispatching. By default events are dispatched on the main thread.

callback

The callback to retrieve SearchResult with resolved coordinates.


abstract fun select(suggestions: List<SearchSuggestion>, executor: Executor, callback: SearchMultipleSelectionCallback): AsyncOperationTask

Deprecated

Consider making a selection of only one Search Suggestion

Deprecated, consider making a selection of only one Search Suggestion.

Function to select multiple suggestions at once. Unlike select, resolving always ends up returning list of SearchResult and can't return new suggestions.

Note that all the search suggestions must originate from the same search request and only certain suggestions can be used in the batch selection, to check if a SearchSuggestion can be passed to this function, call SearchSuggestion.isBatchResolveSupported. With the current implementation, only POI and indexable record suggestions support batch resolving. All the suggestions that can't be used in batch resolving will be filtered.

Please note that this function is not supported for ApiType.SEARCH_BOX. If this SearchEngine was created with ApiType.SEARCH_BOX, the SearchMultipleSelectionCallback.onError will be triggered immediately.

Return

AsyncOperationTask object representing pending completion of the request.

Parameters

suggestions

Search suggestions to resolve. Suggestions that don't support batch resolving will be filtered.

executor

Executor used for events dispatching. By default events are dispatched on the main thread.

callback

The callback to retrieve SearchResult with resolved coordinates.


open fun select(suggestions: List<SearchSuggestion>, callback: SearchMultipleSelectionCallback): AsyncOperationTask

Deprecated

Consider making a selection of only one Search Suggestion

Deprecated, consider making a selection of only one Search Suggestion.

Function to select multiple suggestions at once. Unlike select, resolving always ends up returning list of SearchResult and can't return new suggestions.

Note that all the search suggestions must originate from the same search request and only certain suggestions can be used in the batch selection, to check if a SearchSuggestion can be passed to this function, call SearchSuggestion.isBatchResolveSupported. With the current implementation, only POI and indexable record suggestions support batch resolving. All the suggestions that can't be used in batch resolving will be filtered.

Please note that this function is not supported for ApiType.SEARCH_BOX. If this SearchEngine was created with ApiType.SEARCH_BOX, the SearchMultipleSelectionCallback.onError will be triggered immediately.

Return

AsyncOperationTask object representing pending completion of the request.

Parameters

suggestions

Search suggestions to resolve. Suggestions that don't support batch resolving will be filtered.

callback

The callback to retrieve SearchResult with resolved coordinates. Events are dispatched on the main thread.