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

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

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

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

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

אם לא מציינים תאריך, ברירת המחדל היא תמונת המצב העדכנית ביותר.

 STRING

פורמט: YYYY-MM

לדוגמה: "2026-07"
month1

לPLACES_COUNT_CHANGE בלבד

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

 STRING

פורמט: YYYY-MM

לדוגמה: "2026-01"
month2

לPLACES_COUNT_CHANGE בלבד

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

 STRING

פורמט: YYYY-MM

לדוגמה: "2026-02"
regular_opening_hours

מסננים מקומות לפי שעות הפתיחה הרגילות שלהם.

 JSON

לדוגמה: JSON_OBJECT('monday', [JSON_OBJECT('start_time', '09:00', 'end_time', '12:00')])
min_ev_charge_connector_count

מציין את המספר המינימלי של מחברי טעינה לרכב חשמלי.

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

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

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

מציינת את קצב הטעינה המקסימלי בקילוואט (kW) לתחנות טעינה לרכבים חשמליים.

 FLOAT64 הערך המינימלי הוא 0.0.
ev_charge_connector_types

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

 ARRAY<STRING>

לדוגמה: ["EV_CONNECTOR_TYPE_TESLA"]