Get Started Contact sales

GooglePlaces Framework Reference

  • GMSAutocompletePrediction objects represent predicted search queries based on partial user input.

  • Predictions include attributed text for the full description, primary text (place name), and secondary text (location).

  • Each prediction provides a placeID for detailed place information requests and an array of types describing the result.

  • Optionally, distanceMeters indicates the distance from the origin specified in the request's filter.

GMSAutocompletePrediction

Deprecated

Use GMSAutocompleteSuggestion instead.


@interface GMSAutocompletePrediction : NSObject

This class represents a prediction of a full query based on a partially typed string.

  • Deprecated

    Use GMSAutocompleteSuggestion instead.

    The full description of the prediction as a NSAttributedString. E.g., “Sydney Opera House, Sydney, New South Wales, Australia”.

    Every text range that matches the user input has a kGMSAutocompleteMatchAttribute. For example, you can make every match bold using enumerateAttribute: 

       UIFont *regularFont = [UIFont systemFontOfSize:[UIFont labelFontSize]];
   UIFont *boldFont = [UIFont boldSystemFontOfSize:[UIFont labelFontSize]];
    


    NSMutableAttributedString *bolded = [prediction.attributedFullText mutableCopy];
   [bolded enumerateAttribute:kGMSAutocompleteMatchAttribute
                      inRange:NSMakeRange(0, bolded.length)
                      options:0
                   usingBlock:^(id value, NSRange range, BOOL *stop) {
                     UIFont *font = (value == nil) ? regularFont : boldFont;
                     [bolded addAttribute:NSFontAttributeName value:font range:range];
                   }];
    


    label.attributedText = bolded;

    Declaration

    Swift

    @NSCopying var attributedFullText: NSAttributedString { get }

    Objective-C

    @property (nonatomic, copy, readonly) __GMS_AVAILABLE_BUT_DEPRECATED_MSG NSAttributedString *attributedFullText;

  • Deprecated

    Use GMSAutocompleteSuggestion instead.

    The main text of a prediction as a NSAttributedString, usually the name of the place. E.g. “Sydney Opera House”.

    Text ranges that match user input are have a kGMSAutocompleteMatchAttribute, like attributedFullText.

    Declaration

    Swift

    @NSCopying var attributedPrimaryText: NSAttributedString { get }

    Objective-C

    @property (nonatomic, copy, readonly) __GMS_AVAILABLE_BUT_DEPRECATED_MSG NSAttributedString *attributedPrimaryText;

  • Deprecated

    Use GMSAutocompleteSuggestion instead.

    The secondary text of a prediction as a NSAttributedString, usually the location of the place. E.g. “Sydney, New South Wales, Australia”.

    Text ranges that match user input are have a kGMSAutocompleteMatchAttribute, like attributedFullText.

    May be nil.

    Declaration

    Swift

    @NSCopying var attributedSecondaryText: NSAttributedString? { get }

    Objective-C

    @property (nonatomic, copy, readonly, nullable) NSAttributedString *attributedSecondaryText;

  • Deprecated

    Use GMSAutocompleteSuggestion instead.

    A property representing the place ID of the prediction, suitable for use in a place details request.

    Declaration

    Swift

    var placeID: String { get }

    Objective-C

    @property (nonatomic, copy, readonly) __GMS_AVAILABLE_BUT_DEPRECATED_MSG NSString *placeID;

  • Deprecated

    Use GMSAutocompleteSuggestion instead.

    The types of this autocomplete result. Types are NSStrings, valid values are any types documented at https://developers.google.com/places/ios-sdk/supported_types.

    Declaration

    Swift

    var types: [String] { get }

    Objective-C

    @property (nonatomic, copy, readonly) __GMS_AVAILABLE_BUT_DEPRECATED_MSG NSArray<NSString *> *types;

  • Deprecated

    Use GMSAutocompleteSuggestion instead.

    The straight line distance in meters between the origin and this prediction if a valid origin is specified in the GMSAutocompleteFilter of the request.

    Declaration

    Swift

    var distanceMeters: NSNumber? { get }

    Objective-C

    @property (nonatomic, readonly, nullable) NSNumber *distanceMeters;

  • Deprecated

    Use GMSAutocompleteSuggestion instead.

    Unavailable

    Initializer is not available.

    Declaration

    Objective-C

    - (nonnull instancetype)init;