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

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

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

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

ב-PLACES_COUNT, PLACES_COUNT_PER_TYPE ו-PLACES_COUNT_PER_H3

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

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

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

 GEOGRAPHY כל סוג של GEOGRAPHY.
geographies

רק ל-PLACES_COUNT_PER_GEO

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

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

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

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

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

הערך שצוין חייב להגדיר אזור חיפוש מינימלי של 40.0 מטרים על 40.0 מטרים (1,600 מ"ר). לדוגמה, באזור גיאוגרפי של 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

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

אפשר לשייך לכל מקום מזהי מותגים. אם לא מציינים מזהי מותגים, כל המותגים (והמקומות בלי קשר למותג) נכללים בתוצאה.

הערה: נתוני מותגים נתמכים רק במדינות מסוימות. נכון לעכשיו: ארצות הברית (US), קנדה (CA), בריטניה (GB) ואוסטרליה (AU).

 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

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

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

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

 ARRAY<STRING>

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