Documentation
Initialization
There are two ways to perform a search:
- Create a SearchAPI (android-sdk-search) object
- Start and bind to a SearchService (android-sdk-search-extensions)
You should use the first option if you want to handle multithreading / orientation changing and caching by yourself. The second option is dedicated to you if you want to have an easy, out of the box Android Service which will handle most of the mentioned problems by itself. Both options are described in the following section. They all use the same public API. In both cases you will need the appropriate Search API Key. For more information on obtaining and configuring TomTom API Keys and their configuration, go to the "Getting started" subpage.
A SearchApi
object is created in the following manner:
The alternative to using a SearchAPI object is to create the SearchService. To do so, first use SearchServiceManager to create a ServiceConnection object and set SearchServiceConnectionCallback to react on bind to the service event:
To unbind from SearchService use the following:
In the preceding example, the SearchFragmentPresenter was chosen to play the role of a listener on a source callback. An example implementation can be as follows:
The Android Search API provides simple yet very handy search functionality. An application developer can implement his own search component using either a classic callback-based approach or use a reactive search.
the first approach involves using the void search() method, taking the SearchQuery and FuzzySearchResultListener implementation as parameters. Implementation of FuzzySearchResultListener should cover the following two methods:
void onSearchResult(FuzzySearchResponse results);
void onSearchError(final SearchError error);
The methods are calling back a list of SearchResult objects with corresponding content. All poles of SearchResult have associated getters, so its information is easily accessible.
Another way to subscribe a search response is to use a reactive search method. It returns a
RxJavas Observable<List<SearchResult>>
. To take advantage of this implementation, one has to
subscribe for it (for instance with a Disposable<List<SearchResult>>
or
a Consumer<List<SearchResult>>
.
An example implementation can look like the following code:
Example implementation of subscriber:
Please note, a consecutive search request cannot be made before its successor’s callback (either onSearchResult or onSearchError) is received.
Concurrent search requests are not handled in the current version of the Maps SDK for Android, and an internal error is reported.