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

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

• ‫PLACES_COUNT: נדרש geography
• ‫PLACES_COUNT_PER_TYPE: נדרשים geography וגם type
• ‫PLACES_COUNT_PER_GEO: נדרש geographies
• ‫PLACES_COUNT_PER_H3: נדרשים geography ו-h3_resolution

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

שם המסנן	תיאור	סוג	ערכים נתמכים
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_type	מציין את הסוגים העיקריים שצריך להביא בחשבון. לכל מקום יכול להיות רק סוג ראשי אחד, שהוא הסוג שמתאר בצורה הכי טובה את המיקום. אם לא מציינים סוגים ראשיים, כל הסוגים הראשיים של המקומות נלקחים בחשבון בתוצאה.	ARRAY<STRING>	רשימה מלאה של הערכים האפשריים זמינה במאמר בנושא סוגי מקומות. דוגמה: ["restaurant", "cafe", "bar"]
brand_ids	ל-PLACES_COUNT_PER_H3, ל-PLACES_COUNT_V2 ול-PLACES_COUNT_PER_TYPE_V2 בלבד מציין את מזהי המותגים שצריך לקחת בחשבון. אפשר לשייך לכל מקום מזהי מותג. אם לא מציינים מזהי מותגים, כל המותגים (ומקומות בלי קשר למותג) נכללים בתוצאה. הערה: נתוני מותגים נתמכים רק במדינות מסוימות. נכון לעכשיו: אוסטרליה (AU), ארה"ב (US), בריטניה (GB) וקנדה (CA).	ARRAY<STRING>	מערך של מזהי מותגים. מידע נוסף על נתוני מותגים זמין במאמר בנושא כתיבת שאילתה באמצעות נתוני מותגים. דוגמה: ["brand_001", "brand_002"]
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" "FUTURE_OPENING" דוגמה: ["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