GooglePlaces Framework Reference

AI-generated Key Takeaways

• GMSAutocompleteResultsViewControllerDelegate is a protocol used to handle user interactions within GMSAutocompleteResultsViewController.

• It provides callbacks for successful autocomplete selections, errors during the process, and prediction selections.

• The delegate also informs when autocomplete predictions are updated or requested.

• Callbacks offer details like the selected place, prediction, or error encountered, aiding in application logic.

GMSAutocompleteResultsViewControllerDelegate

Deprecated

Use the placeAutocomplete View extension in Places Swift SDK (https://developers.google.com/maps/documentation/places/ios-sdk/google-places-swift) instead.

@protocol GMSAutocompleteResultsViewControllerDelegate <NSObject>

Protocol used by GMSAutocompleteResultsViewController, to communicate the user’s interaction with the controller to the application.

• -resultsController:didAutocompleteWithPlace:

  Deprecated

  Use the placeAutocomplete View extension in Places Swift SDK (https://developers.google.com/maps/documentation/places/ios-sdk/google-places-swift) instead.

  Called when a place has been selected from the available autocomplete predictions.

  Declaration

  Swift

  func resultsController(_ resultsController: GMSAutocompleteResultsViewController, didAutocompleteWith place: GMSPlace)

  Objective-C

  - (void)resultsController:
              (nonnull GMSAutocompleteResultsViewController *)resultsController
      didAutocompleteWithPlace:(nonnull GMSPlace *)place;

  Parameters

  resultsController	The GMSAutocompleteResultsViewController that generated the event.
  place	The GMSPlace that was returned.

• -resultsController:didFailAutocompleteWithError:

  Deprecated

  Use the placeAutocomplete View extension in Places Swift SDK (https://developers.google.com/maps/documentation/places/ios-sdk/google-places-swift) instead.

  Called when a non-retryable error occurred when retrieving autocomplete predictions or place details. A non-retryable error is defined as one that is unlikely to be fixed by immediately retrying the operation.

  Only the following values of GMSPlacesErrorCode are retryable:

  • kGMSPlacesNetworkError
  • kGMSPlacesServerError
  • kGMSPlacesInternalError

  All other error codes are non-retryable.

  Declaration

  Swift

  func resultsController(_ resultsController: GMSAutocompleteResultsViewController, didFailAutocompleteWithError error: any Error)

  Objective-C

  - (void)resultsController:
              (nonnull GMSAutocompleteResultsViewController *)resultsController
      didFailAutocompleteWithError:(nonnull NSError *)error;

  Parameters

  resultsController	The GMSAutocompleteResultsViewController that generated the event.
  error	The NSError that was returned.

• -resultsController:didSelectPrediction:

  Deprecated

  Use the placeAutocomplete View extension in Places Swift SDK (https://developers.google.com/maps/documentation/places/ios-sdk/google-places-swift) instead.

  Called when the user selects an autocomplete prediction from the list but before requesting place details. Returning NO from this method will suppress the place details fetch and didAutocompleteWithPlace will not be called.

  Declaration

  Swift

  optional func resultsController(_ resultsController: GMSAutocompleteResultsViewController, didSelect prediction: GMSAutocompletePrediction) -> Bool

  Objective-C

  - (BOOL)resultsController:
              (nonnull GMSAutocompleteResultsViewController *)resultsController
        didSelectPrediction:(nonnull GMSAutocompletePrediction *)prediction;

  Parameters

  resultsController	The GMSAutocompleteResultsViewController that generated the event.
  prediction	The GMSAutocompletePrediction that was selected.

• -didUpdateAutocompletePredictionsForResultsController:

  Deprecated

  Use the placeAutocomplete View extension in Places Swift SDK (https://developers.google.com/maps/documentation/places/ios-sdk/google-places-swift) instead.

  Called once every time new autocomplete predictions are received.

  Declaration

  Swift

  optional func didUpdateAutocompletePredictions(forResultsController resultsController: GMSAutocompleteResultsViewController)

  Objective-C

  - (void)didUpdateAutocompletePredictionsForResultsController:
      (nonnull GMSAutocompleteResultsViewController *)resultsController;

  Parameters

  resultsController

  The GMSAutocompleteResultsViewController that generated the event.

• -didRequestAutocompletePredictionsForResultsController:

  Deprecated

  Use the placeAutocomplete View extension in Places Swift SDK (https://developers.google.com/maps/documentation/places/ios-sdk/google-places-swift) instead.

  Called once immediately after a request for autocomplete predictions is made.

  Declaration

  Swift

  optional func didRequestAutocompletePredictions(forResultsController resultsController: GMSAutocompleteResultsViewController)

  Objective-C

  - (void)didRequestAutocompletePredictionsForResultsController:
      (nonnull GMSAutocompleteResultsViewController *)resultsController;

  Parameters

  resultsController

  The GMSAutocompleteResultsViewController that generated the event.