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

הפניה לכיתה GMSPlaceSearchByTextRequest

סקירה כללית

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

פונקציות חברים ציבוריים

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

מאפיינים

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

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

- (instancetype) initWithTextQuery: (NSString *) textQuery
placeProperties: (NSArray< GMSPlaceProperty > *) placeProperties

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

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

תיעוד של נכס

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

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

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

הרשימה העדכנית ביותר של סוגי תמיכה זמינים זמינה בכתובת https://developers.google.com/maps/documentation/places/web-service/search-textual#supported-types.

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

המספר המקסימלי של תוצאות שיש להחזיר.

אפשר להזין ערכים בין 1 ל-20.

ניתן למצוא את הטווח המותר של השדה הזה בכתובת https://developers.google.com/maps/documentation/places/web-service/search-textual#maxresultcount.

ברירת המחדל היא התקרה העליונה.

- (צף) 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.

לא ניתן להשתמש בו עם locationBias.

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