GooglePlaces Framework Reference

GMSAutocompletePlaceSuggestion

@interface GMSAutocompletePlaceSuggestion : NSObject

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

  • The full description of the suggestion 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 = [suggestion.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) NSAttributedString *_Nonnull attributedFullText;

  • The primary text of a suggestion as a NSAttributedString, usually the name of the place. E.g. “Sydney Opera House”.

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

    Declaration

    Swift

    @NSCopying var attributedPrimaryText: NSAttributedString { get }

    Objective-C

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

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

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

    May be nil.

    Declaration

    Swift

    @NSCopying var attributedSecondaryText: NSAttributedString? { get }

    Objective-C

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

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

    Declaration

    Swift

    var placeID: String { get }

    Objective-C

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

  • Autocomplete result types. 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) NSArray<NSString *> *_Nonnull types;

  • The straight line distance in meters between the origin and this suggestion 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;