GMSAutocompleteFetcher Class Reference

GMSAutocompleteFetcher Class Reference

Overview

GMSAutocompleteFetcher is a wrapper around the lower-level autocomplete APIs that encapsulates some of the complexity of requesting autocomplete predictions as the user is typing.

Calling sourceTextHasChanged will generally result in the provided delegate being called with autocomplete predictions for the queried text, with the following provisos:

  • The fetcher may not necessarily request predictions on every call of sourceTextHasChanged if several requests are made within a short amount of time.
  • The delegate will only be called with prediction results if those predictions are for the text supplied in the most recent call to sourceTextHasChanged.

Public Member Functions

(instancetype) - initWithFilter:
 Initialize the fetcher.
(void) - provideSessionToken:
 Provide a GMSAutocompleteSessionToken for tracking the specific autocomplete query flow.
(void) - sourceTextHasChanged:
 Notify the fetcher that the source text to autocomplete has changed.

Properties

id
< GMSAutocompleteFetcherDelegate
delegate
 Delegate to be notified with autocomplete prediction results.
GMSAutocompleteFilterautocompleteFilter
 Filter to apply to autocomplete suggestions (can be nil).

Member Function Documentation

- (instancetype) initWithFilter: (nullable GMSAutocompleteFilter *)  filter

Initialize the fetcher.

Parameters:
filterThe filter to apply to the results. This parameter may be nil.
- (void) provideSessionToken: (nullable GMSAutocompleteSessionToken *)  sessionToken

Provide a GMSAutocompleteSessionToken for tracking the specific autocomplete query flow.

- (void) sourceTextHasChanged: (nullable NSString *)  text

Notify the fetcher that the source text to autocomplete has changed.

This method should only be called from the main thread. Calling this method from another thread will result in undefined behavior. Calls to GMSAutocompleteFetcherDelegate methods will also be called on the main thread.

This method is non-blocking.

Parameters:
textThe partial text to autocomplete.

Property Documentation

- (id<GMSAutocompleteFetcherDelegate>) delegate [read, write, assign]

Delegate to be notified with autocomplete prediction results.

- (GMSAutocompleteFilter*) autocompleteFilter [read, write, assign]

Filter to apply to autocomplete suggestions (can be nil).