חומר עזר בנושא כיתת שירות 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 *>*) סוגים [read, copy]

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

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

- (NSNumber*) distanceMeters [read, assign]

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