מסמך עזר בנושא GMSPlaceSearchByTextRequest

מסמך עזר בנושא GMSPlaceSearchByTextRequest

סקירה כללית

מייצג הגדרה של בקשה לחיפוש טקסט שתישלח דרך GMSPlacesClient

פונקציות של חברי מועדון

(instancetype)- initWithTextQuery:placeProperties:
 יוצר GMSPlaceSearchByTextRequest עם שאילתת טקסט ומאפייני מקום להחזרה.

נכסים

NSString * includedType
 אתחול ברירת המחדל אינו זמין.
 המספר המקסימלי של תוצאות שיש להחזיר. אפשר להזין ערכים בין 1 ל-20.
int maxResultCount
float minRating
 דירוג המשתמשים הממוצע המינימלי של מקומות שייכללו בתוצאות.
בוליאניisOpenNow
 סינון התוצאות לפי מקומות שפתוחים עכשיו.
NSArray< GMSPlaceProperty > * placeProperties
 המערך של GMSPlaceProperty שצריך לכלול בתוצאות של מקומות.
NSArray< NSNumber * > * priceLevels
 מערך של הערכים GMSPlacesPriceLevel שצריכים לסנן את המקומות שנכללים בתוצאות.
העדפת GMSPlaceSearchByTextRankrankPreference
 הפונקציה GMSPlaceSearchByTextRankPreference משמשת למיון התוצאות שהוחזרו מהבקשה.
NSString * regionCode
 קוד ה-Unicode של המדינה או האזור (CLDR) של המיקום שממנו נשלחה הבקשה.
בוליאניisStrictTypeFiltering
 הגדרה זו קובעת אם יש להחזיר רק תוצאות של includedType.
NSString * textQuery
 שאילתת הטקסט של החיפוש.
id< GMSPlaceLocationBias >locationBias
 האזור המוטה לחיפוש.
id< GMSPlaceLocationRestriction >locationRestriction
 האזור המוגבל לחיפוש.

מסמכי תיעוד לגבי פונקציות של חברים

- (instancetype) initWithTextQuery: (NSString *) textQuery
מאפייני המקום: (NSArray< GMSPlaceProperty > *) placeProperties

יוצר GMSPlaceSearchByTextRequest עם שאילתת טקסט ומאפייני מקום להחזרה.

פרמטרים:
textQueryשאילתת המחרוזת של בקשת החיפוש.
placePropertiesהמערך של GMSPlaceProperty שצריך לכלול בתוצאות של מקומות.

תיעוד נכס

- (NSString*) includedType [read, write, copy]

אתחול ברירת המחדל אינו זמין.

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

הרשימה העדכנית ביותר של סוגי המכשירים הנתמכים זמינה בכתובת https://developers.google.com/maps/documentation/maps/documentation/places/ios-sdk/data-fields.

- (int) maxResultCount [read, write, assign]

המספר המקסימלי של תוצאות שיש להחזיר. אפשר להזין ערכים בין 1 ל-20.

ניתן למצוא את הטווח המותר בשדה הזה בכתובת https://developers.google.com/maps/documentation/places/ios-sdk/text-search.

ערך ברירת המחדל הוא הגבול העליון.

- (מספר ממשי) minRating [read, write, assign]

דירוג המשתמשים הממוצע המינימלי של מקומות שייכללו בתוצאות.

הדירוג יהיה בטווח שבין 0.0 ל-5.0.

הדירוג שצוין יעוגל כלפי מעלה ל-0.5 הקרוב ביותר. הצגת נכס דירוג של GMSPlace.

ברירת המחדל היא 0.0.

- (BOOL) isOpenNow [read, write, assign]

סינון התוצאות לפי מקומות שפתוחים עכשיו.

ברירת המחדל היא True.

- (NSArray<GMSPlaceProperty>*) placeProperties [read, assign]

המערך של GMSPlaceProperty שצריך לכלול בתוצאות של מקומות.

- (NSArray<NSNumber *>*) priceLevels [read, write, assign]

מערך של הערכים GMSPlacesPriceLevel שצריכים לסנן את המקומות שנכללים בתוצאות.

אפשר לבחור כל שילוב של רמות מחירים. ברירת המחדל היא 'כל רמות המחירים'.

- (GMSPlaceSearchByTextRankPreference) rankPreference [read, write, assign]

הפונקציה GMSPlaceSearchByTextRankPreference משמשת למיון התוצאות שהוחזרו מהבקשה.

- (NSString*) regionCode [read, write, copy]

קוד ה-Unicode של המדינה או האזור (CLDR) של המיקום שממנו נשלחה הבקשה.

האזור עשוי להשפיע על הפורמט והסוג של הנתונים שמוחזרים. אם לא סופק קוד, אין הטיה כלפי כל מדינה/אזור.

קודים של אזורים זמינים בכתובת https://unicode.org/cldr/charts/latest/supplemental/territory_containment_un_m_49.html.

- (BOOL) isStrictTypeFiltering [read, write, assign]

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

ערך ברירת המחדל הוא False.

- (NSString*) textQuery [read, copy]

שאילתת הטקסט של החיפוש.

- (id<GMSPlaceLocationBias>) locationBias [read, write, assign]

האזור המוטה לחיפוש.

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

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

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

- (id<GMSPlaceLocationRestriction>) locationRestriction [read, write, assign]

האזור המוגבל לחיפוש.

המיקום הזה משמש כהגבלה, כלומר לא יוחזרו תוצאות מחוץ למיקום הנתון.

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

לא ניתן להשתמש עם בינה מלאכותית גנרטיבית.

הגבלת המיקום עבור חיפוש טקסט תומכת רק ב-GMSPlaceRectangularLocationOption.