GooglePlaces Framework Reference

AI-generated Key Takeaways

• GMSAutocompleteViewController presents an interface for users to select a place from a list of autocomplete predictions.

• Place selections are communicated back to the app through the GMSAutocompleteViewControllerResultsDelegate protocol.

• Developers can customize the appearance of the autocomplete view, such as colors and table cell styles.

• Filtering of autocomplete suggestions is possible using the autocompleteFilter property.

• The placeFields and placeProperties properties allow for the customization of the level of place details returned upon selection.

GMSAutocompleteViewController

Deprecated

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

@interface GMSAutocompleteViewController : UIViewController

GMSAutocompleteViewController provides an interface that displays a table of autocomplete predictions that updates as the user enters text. Place selections made by the user are returned to the app via the GMSAutocompleteViewControllerResultsDelegate protocol.

To use GMSAutocompleteViewController, set its delegate to an object in your app that conforms to the GMSAutocompleteViewControllerDelegate protocol and present the controller (eg using presentViewController). The GMSAutocompleteViewControllerDelegate delegate methods can be used to determine when the user has selected a place or has cancelled selection.

• delegate

  Deprecated

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

  Delegate to be notified when a place is selected or picking is cancelled.

  Declaration

  Swift

  @IBOutlet weak var delegate: (any GMSAutocompleteViewControllerDelegate)? { get set }

  Objective-C

  @property (nonatomic, weak, nullable) id<GMSAutocompleteViewControllerDelegate> delegate;

• autocompleteFilter

  Deprecated

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

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

  Declaration

  Swift

  var autocompleteFilter: GMSAutocompleteFilter? { get set }

  Objective-C

  @property (nonatomic, strong, nullable) GMSAutocompleteFilter *autocompleteFilter;

• tableCellBackgroundColor

  Deprecated

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

  The background color of table cells.

  Declaration

  Swift

  var tableCellBackgroundColor: UIColor { get set }

  Objective-C

  @property (nonatomic, strong) __GMS_AVAILABLE_BUT_DEPRECATED_MSG UIColor *tableCellBackgroundColor;

• tableCellSeparatorColor

  Deprecated

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

  The color of the separator line between table cells.

  Declaration

  Swift

  var tableCellSeparatorColor: UIColor { get set }

  Objective-C

  @property (nonatomic, strong) __GMS_AVAILABLE_BUT_DEPRECATED_MSG UIColor *tableCellSeparatorColor;

• primaryTextColor

  Deprecated

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

  The color of result name text in autocomplete results

  Declaration

  Swift

  var primaryTextColor: UIColor { get set }

  Objective-C

  @property (nonatomic, strong) __GMS_AVAILABLE_BUT_DEPRECATED_MSG UIColor *primaryTextColor;

• primaryTextHighlightColor

  Deprecated

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

  The color used to highlight matching text in autocomplete results

  Declaration

  Swift

  var primaryTextHighlightColor: UIColor { get set }

  Objective-C

  @property (nonatomic, strong) __GMS_AVAILABLE_BUT_DEPRECATED_MSG UIColor *primaryTextHighlightColor;

• secondaryTextColor

  Deprecated

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

  The color of the second row of text in autocomplete results.

  Declaration

  Swift

  var secondaryTextColor: UIColor { get set }

  Objective-C

  @property (nonatomic, strong) __GMS_AVAILABLE_BUT_DEPRECATED_MSG UIColor *secondaryTextColor;

• tintColor

  Deprecated

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

  The tint color applied to controls in the Autocomplete view.

  Declaration

  Swift

  var tintColor: UIColor? { get set }

  Objective-C

  @property (nonatomic, strong, nullable) UIColor *tintColor;

• placeFields

  Deprecated

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

  Specify individual place details to fetch for object GMSPlace. Defaults to returning all details if not overridden.

  Declaration

  Swift

  var placeFields: GMSPlaceField { get set }

  Objective-C

  @property (nonatomic) GMSPlaceField placeFields;

• placeProperties

  Deprecated

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

  The GMSPlaceProperty for specifying explicit place details to be requested. Default returns all available properties.

  Declaration

  Swift

  var placeProperties: [String] { get set }

  Objective-C

  @property (nonatomic, strong) __GMS_AVAILABLE_BUT_DEPRECATED_MSG NSArray<NSString *> *placeProperties;