פרמטרים של מסננים

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

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

שם המסנן תיאור סוג ערכים נתמכים
geography

ב-PLACES_COUNT, ב-PLACES_COUNT_PER_TYPE וב-PLACES_COUNT_PER_H3

מציין אזור לחיפוש. כל סוג של GEOGRAPHY נתמך, כמו Point, ‏ LineString ו-Polygon.

אפשר להשתמש בפרמטר geography בשילוב עם geography_radius כדי להוסיף אזור חיץ לאזור החיפוש.

אזור החיפוש המינימלי הוא 40.0 מטר על 40.0 מטר (1,600 מ'2). אם מציינים אזור חיפוש מתחת למגבלה הזו, הפונקציה מחזירה שגיאת ארגומנט לא חוקי.

 GEOGRAPHY כל סוג של GEOGRAPHY.
geographies

לPLACES_COUNT_PER_GEO בלבד

מציין רשימה של אזורים לחיפוש. כל סוג של GEOGRAPHY נתמך, כמו Point, ‏ LineString ו-Polygon.

אפשר להשתמש בפרמטר geographies בשילוב עם geography_radius כדי להוסיף אזור חיץ לאזור החיפוש. האזור המבודד מתווסף לכל האזורים הגיאוגרפיים שצוינו.

אזור החיפוש המינימלי הוא 40.0 מטר על 40.0 מטר (1,600 מ'2). אם מציינים אזור חיפוש מתחת למגבלה הזו, הפונקציה מחזירה שגיאת ארגומנט לא חוקי.

 ARRAY<GEOGRAPHY> כל סוג של GEOGRAPHY.
geography_radius

הוספת רדיוס או אזור חיץ, במטרים, למיקום הגיאוגרפי שצוין. ערך ברירת המחדל הוא 0.

הערך שצוין צריך להגדיר אזור חיפוש מינימלי של 40.0 מטר על 40.0 מטר (1,600 מ'2). לדוגמה, עבור מיקום גיאוגרפי Point, הרדיוס המינימלי הוא 23 מטרים.

 INT64 הערך המינימלי הוא 0.
h3_resolution

לPLACES_COUNT_PER_H3 בלבד

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

 INT64 בין 0 ל-8.
types

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

כל מקום מכיל קבוצה של סוגי מקומות, למשל "restaurant" ו-"cafe". אם לא מציינים סוגים, כל סוגי המקומות נכללים בתוצאה.

 ARRAY<STRING>

רשימה מלאה של הערכים האפשריים מופיעה בטבלה א' ובטבלה ב' במאמר סוגי מקומות.

דוגמה:

["restaurant", "cafe", "bar"]
primary_types

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

לכל מקום יכול להיות רק סוג ראשי אחד, שהוא הסוג שמתאר בצורה הכי טובה את המיקום.

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

 ARRAY<STRING>

רשימה מלאה של הערכים האפשריים מופיעה בטבלה א' ובטבלה ב' במאמר סוגי מקומות.

דוגמה:

["restaurant", "cafe", "bar"]
min_rating מציין את דירוג המקום המינימלי שצריך לקחת בחשבון.

דירוג מקום מבוסס על ביקורות משתמשים על המקום, והוא נע בין 1.0 ל-5.0

אם מציינים דירוג מחוץ לטווח הזה, הפונקציה מחזירה שגיאה של ארגומנט לא חוקי.

 FLOAT בין 1.0 ל-5.0.
max_rating

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

דירוג מקום מבוסס על ביקורות משתמשים על המקום, והוא נע בין 1.0 ל-5.0

אם מציינים דירוג מחוץ לטווח הזה, הפונקציה מחזירה שגיאה של ארגומנט לא חוקי.

 FLOAT בין 1.0 ל-5.0.
min_user_rating_count

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

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

הערך המינימלי הוא 0. אם מציינים ערך מתחת ל-0, הפונקציה מחזירה שגיאה של ארגומנט לא חוקי.

 INT64 הערך המינימלי הוא 0.
max_user_rating_count

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

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

הערך המינימלי הוא 0. אם מציינים ערך מתחת ל-0, הפונקציה מחזירה שגיאה של ארגומנט לא חוקי.

 INT64 הערך המינימלי הוא 0.
price_level

מציין את רמות המחירים שיש להביא בחשבון.

אפשר לציין כמה רמות מחיר.

 ARRAY<STRING>

ערכים נתמכים:

"PRICE_LEVEL_FREE"

"PRICE_LEVEL_INEXPENSIVE"

"PRICE_LEVEL_MODERATE"

"PRICE_LEVEL_EXPENSIVE"

"PRICE_LEVEL_VERY_EXPENSIVE"

דוגמה:

["PRICE_LEVEL_MODERATE","PRICE_LEVEL_EXPENSIVE"]
business_status מציינים את הסטטוס של העסק שרוצים להתייחס אליו. אפשר לציין כמה סטטוסים של עסקים. ARRAY<STRING>

ערכים נתמכים:

"OPERATIONAL"

"CLOSED_TEMPORARILY"

"CLOSED_PERMANENTLY"

דוגמה:

["OPERATIONAL","CLOSED_TEMPORARILY"]
takeout החיפוש כולל מקומות שמציעים אוכל ארוז. BOOLEAN TRUE, FALSE
delivery חיפוש מקומות שמציעים משלוחים. BOOLEAN TRUE, FALSE
dine_in המערכת מחפשת מקומות שאפשר לאכול בהם. BOOLEAN TRUE, FALSE
curbside_pickup חיפוש מקומות שמציעים איסוף מחוץ לדלת העסק. BOOLEAN TRUE, FALSE
reservable כדאי לחפש מקומות שאפשר להזמין בהם מקום. BOOLEAN TRUE, FALSE
outdoor_seating התוצאות כוללות מקומות עם מקומות ישיבה בחוץ. BOOLEAN TRUE, FALSE
live_music החיפוש כולל מקומות שמתקיימות בהם הופעות חיות. BOOLEAN TRUE, FALSE
allows_dogs כדאי לבחור מקומות שמותר להכניס אליהם כלבים. BOOLEAN TRUE, FALSE
restroom כולל מקומות עם שירותים. BOOLEAN TRUE, FALSE
serves_breakfast מביא בחשבון מקומות שמגישים ארוחת בוקר. BOOLEAN TRUE, FALSE
serves_lunch החיפוש כולל מקומות שמגישים ארוחת צהריים. BOOLEAN TRUE, FALSE
serves_dinner החיפוש כולל מקומות שמגישים ארוחת ערב. BOOLEAN TRUE, FALSE
serves_beer הוא מתייחס למקומות שמגישים בירה. BOOLEAN TRUE, FALSE
serves_wine החיפוש כולל מקומות שמגישים יין. BOOLEAN TRUE, FALSE
serves_brunch הוא מתייחס למקומות שמגישים בראנץ'. BOOLEAN TRUE, FALSE
serves_vegetarian_food החיפוש כולל מקומות שמגישים אוכל צמחוני. BOOLEAN TRUE, FALSE
serves_cocktails התשובה מתייחסת למקומות שמגישים קוקטיילים. BOOLEAN TRUE, FALSE
serves_dessert החיפוש כולל מקומות שמגישים קינוחים. BOOLEAN TRUE, FALSE
serves_coffee השאלה רלוונטית למקומות שמגישים קפה. BOOLEAN TRUE, FALSE
menu_for_children החיפוש כולל מקומות שמציעים תפריטים לילדים. BOOLEAN TRUE, FALSE
good_for_children כדאי לחפש מקומות שמתאימים לילדים. BOOLEAN TRUE, FALSE
good_for_groups כדאי לחפש מקומות שמתאימים לקבוצות. BOOLEAN TRUE, FALSE
good_for_watching_sports כדאי לחפש מקומות שמתאימים לצפייה בספורט. BOOLEAN TRUE, FALSE
accepts_credit_cards כדאי לבחור מקומות שמקבלים כרטיסי אשראי. BOOLEAN TRUE, FALSE
accepts_debit_cards כדאי לבחור מקומות שמקבלים כרטיסי חיוב מיידי. BOOLEAN TRUE, FALSE
accepts_cash_only כדאי לחפש מקומות שמקבלים תשלום במזומן בלבד. BOOLEAN TRUE, FALSE
accepts_nfc כדאי לחפש מקומות שמקבלים תשלומים באמצעות NFC. BOOLEAN TRUE, FALSE
free_parking_lot החיפוש כולל מקומות עם מגרש חניה בחינם. BOOLEAN TRUE, FALSE
paid_parking_lot החיפוש כולל מקומות עם מגרש חניה בתשלום. BOOLEAN TRUE, FALSE
free_street_parking החיפוש כולל מקומות עם חניה ברחוב בחינם. BOOLEAN TRUE, FALSE
paid_street_parking החיפוש כולל מקומות עם חניה ברחוב בתשלום. BOOLEAN TRUE, FALSE
valet_parking החיפוש כולל מקומות עם שירות החניית רכבים. BOOLEAN TRUE, FALSE
free_garage_parking החיפוש כולל מקומות עם חניון בחינם. BOOLEAN TRUE, FALSE
paid_garage_parking החיפוש כולל מקומות עם חניון בתשלום. BOOLEAN TRUE, FALSE
wheelchair_accessible_parking החיפוש כולל מקומות עם חנייה נגישה לכיסאות גלגלים. BOOLEAN TRUE, FALSE
wheelchair_accessible_entrance החיפוש כולל מקומות עם כניסה נגישה לכיסאות גלגלים. BOOLEAN TRUE, FALSE
wheelchair_accessible_restroom החיפוש כולל מקומות עם שירותים נגישים לכיסאות גלגלים. BOOLEAN TRUE, FALSE
wheelchair_accessible_seating החיפוש כולל מקומות עם מקומות ישיבה נגישים לכיסאות גלגלים. BOOLEAN TRUE, FALSE