חומר עזר בנושא כיתת שירות GMSבדיקות המקום

הפניה לכיתה 'הצעה להשלמה אוטומטית' של GMS

סקירה כללית

המחלקה הזו מייצגת הצעה למקום של שאילתה מלאה שמבוססת על מחרוזת שהוקלדה חלקית.

מאפיינים

NSAttributedString *attributedFullText
 התיאור המלא של ההצעה כ-NSAttributedString.
NSAttributedString *attributedPrimaryText
 הטקסט הראשי של הצעה כ-NSAttributedString, בדרך כלל שם המקום.
NSAttributedString *attributedSecondaryText
 הטקסט המשני של הצעה כ-NSAttributedString, בדרך כלל מיקום המקום.
NSString *placeID
 נכס שמייצג את מזהה המקום של ההצעה, ומתאים לשימוש בבקשה לקבלת פרטי מקום.
NSArray< NSString * > *סוגים
 השלמה אוטומטית של סוגי תוצאות.
NSNumber *distanceMeters
 מרחק הקו הישר במטרים בין המקור לבין ההצעה הזו, אם מצוין מקור תקין ב-GMSAutocompleteFilter של הבקשה.

תיעוד של נכס

- (NSAttributedString*) attributedFullText [read, copy]

התיאור המלא של ההצעה כ-NSAttributedString.

למשל: "בית האופרה של סידני, סידני, ניו סאות' ויילס, אוסטרליה".

לכל טווח טקסט שתואם לקלט של המשתמש יש kGMSAutocompleteMatchAttribute. לדוגמה, אפשר להפוך כל התאמה למודגשת באמצעות הערך 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;
 
- (NSAttributedString*) attributedPrimaryText [read, copy]

הטקסט הראשי של הצעה כ-NSAttributedString, בדרך כלל שם המקום.

לדוגמה "בית האופרה של סידני".

טווחי טקסט שתואמים לקלט של משתמשים כוללים kGMSAutocompleteMatchAttribute, כמו attributedFullText.

- (NSAttributedString*) attributedSecondaryText [read, copy]

הטקסט המשני של הצעה כ-NSAttributedString, בדרך כלל מיקום המקום.

לדוגמה "סידני, ניו סאות' ויילס, אוסטרליה".

טווחי טקסט שתואמים לקלט של משתמשים כוללים kGMSAutocompleteMatchAttribute, כמו attributedFullText.

יכול להיות nil.

- (NSString*) placeID [read, copy]

נכס שמייצג את מזהה המקום של ההצעה, ומתאים לשימוש בבקשה לקבלת פרטי מקום.

- (NSArray<NSString *>*) types [read, copy]

השלמה אוטומטית של סוגי תוצאות.

הסוגים הם NSStrings. הערכים החוקיים הם כל הסוגים המתועדים בכתובת <https://developers.google.com/places/ios-sdk/supported_types>.

- (NSNumber*) distanceMeters [read, assign]

מרחק הקו הישר במטרים בין המקור לבין ההצעה הזו, אם מצוין מקור תקין ב-GMSAutocompleteFilter של הבקשה.