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

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

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

שם המסנן תיאור סוג ערכים נתמכים
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