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

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

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

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