Parametry filtra

Do funkcji zliczania miejsc możesz stosować filtry, używając parametrów opisanych w tabeli poniżej. Pamiętaj, że wymagane parametry różnią się w zależności od funkcji:

• PLACES_COUNT: wymaga geography
• PLACES_COUNT_PER_TYPE_V2: wymaga geography i type
• PLACES_COUNT_V2: wymaga geographies
• PLACES_COUNT_PER_H3: wymaga geography i h3_resolution
• PLACES_COUNT_CHANGE: wymaga month1 i month2

W nazwie filtra i jego wartości wielkość liter ma znaczenie. Musisz je określić dokładnie tak, jak są podane w tabeli. W przeciwnym razie zapytanie zwróci błąd nieprawidłowego argumentu.

Nazwa filtra	Opis	Typ	Obsługiwane wartości
geography	Na potrzeby usług PLACES_COUNT, PLACES_COUNT_PER_TYPE i PLACES_COUNT_PER_H3 Określa obszar wyszukiwania. Obsługiwane są wszystkie typy GEOGRAPHY, takie jak Point, LineString i Polygon. Możesz użyć parametru geography w połączeniu z geography_radius, aby dodać bufor do obszaru wyszukiwania. Minimalny obszar wyszukiwania to 40 m na 40 m (1600 m^2). Jeśli określisz obszar wyszukiwania poniżej tego limitu, funkcja zwróci błąd nieprawidłowego argumentu.	GEOGRAPHY	Dowolny typ GEOGRAPHY.
geographies	Tylko dla: PLACES_COUNT_PER_GEO Określa listę obszarów do wyszukiwania. Obsługiwane są wszystkie typy GEOGRAPHY, takie jak Point, LineString i Polygon. Możesz użyć parametru geographies w połączeniu z geography_radius, aby dodać bufor do obszaru wyszukiwania. Bufor jest dodawany do wszystkich określonych obszarów geograficznych. Minimalny obszar wyszukiwania to 40 m na 40 m (1600 m^2). Jeśli określisz obszar wyszukiwania poniżej tego limitu, funkcja zwróci błąd nieprawidłowego argumentu.	ARRAY<GEOGRAPHY>	Dowolny typ GEOGRAPHY.
geography_radius	Dodaje promień lub bufor (w metrach) do określonego obszaru geograficznego. Wartość domyślna to 0. Podana wartość musi określać minimalny obszar wyszukiwania o wymiarach 40,0 m na 40,0 m (1600 m^2). Na przykład w przypadku obszaru geograficznego Point minimalny promień wynosi 23 metry.	INT64	Minimalna wartość to 0.
h3_resolution	Tylko dla: PLACES_COUNT_PER_H3 Rozdzielczość H3 używana do agregowania liczby miejsc w komórkach H3.	INT64	Od 0 do 11.
types	Określa typy miejsc, które mają być uwzględniane. Każde miejsce zawiera zestaw typów miejsc, na przykład "restaurant" i "cafe". Jeśli nie określisz żadnych typów, w wyniku zostaną uwzględnione wszystkie typy miejsc.	ARRAY<STRING>	Pełną listę możliwych wartości znajdziesz w artykule Typy miejsc. Przykład: ["restaurant", "cafe", "bar"]
primary_type	Określa główne typy, które należy uwzględnić. Miejsce może mieć tylko jeden typ główny, który najlepiej opisuje lokalizację. Jeśli nie określisz żadnych typów głównych, w wyniku zostaną uwzględnione wszystkie typy główne miejsc.	ARRAY<STRING>	Pełną listę możliwych wartości znajdziesz w artykule Typy miejsc. Przykład: ["restaurant", "cafe", "bar"]
brand_ids	Dotyczy tylko usług PLACES_COUNT_PER_H3, PLACES_COUNT_V2 i PLACES_COUNT_PER_TYPE_V2 Określa identyfikatory marek, które mają być uwzględniane. Każde miejsce może być powiązane z identyfikatorami marek. Jeśli nie podasz żadnych identyfikatorów marek, w wynikach zostaną uwzględnione wszystkie marki (oraz miejsca bez nazwy marki). Uwaga: dane o markach są obsługiwane tylko w niektórych krajach. Obecnie: Australia (AU), Kanada (CA), Stany Zjednoczone (US) i Wielka Brytania (GB).	ARRAY<STRING>	Tablica identyfikatorów marek. Więcej informacji o danych o markach znajdziesz w artykule Pisanie zapytania z użyciem danych o markach. Przykład: ["brand_001", "brand_002"]
min_rating	Określa minimalną ocenę miejsca, która ma być brana pod uwagę. Ocena miejsca jest oparta na opiniach użytkowników i mieści się w zakresie od 1,0 do 5,0. Jeśli podasz ocenę spoza tego zakresu, funkcja zwróci błąd nieprawidłowego argumentu.	FLOAT	Od 1,0 do 5,0.
max_rating	Określa maksymalną ocenę miejsca, która ma być brana pod uwagę. Ocena miejsca jest oparta na opiniach użytkowników i mieści się w zakresie od 1,0 do 5,0. Jeśli podasz ocenę spoza tego zakresu, funkcja zwróci błąd nieprawidłowego argumentu.	FLOAT	Od 1,0 do 5,0.
min_user_rating_count	Określa minimalną liczbę ocen użytkowników, które mają być uwzględniane. Liczba ocen użytkowników to łączna liczba opinii o miejscu. Minimalna wartość to 0. Jeśli podasz wartość mniejszą niż 0, funkcja zwróci błąd nieprawidłowego argumentu.	INT64	Minimalna wartość to 0.
max_user_rating_count	Określa maksymalną liczbę ocen użytkowników, które mają być brane pod uwagę. Liczba ocen użytkowników to łączna liczba opinii o miejscu. Minimalna wartość to 0. Jeśli podasz wartość mniejszą niż 0, funkcja zwróci błąd nieprawidłowego argumentu.	INT64	Minimalna wartość to 0.
price_level	Określa poziomy cen, które należy uwzględnić. Możesz określić kilka poziomów cen.	ARRAY<STRING>	Obsługiwane wartości: "PRICE_LEVEL_FREE" "PRICE_LEVEL_INEXPENSIVE" "PRICE_LEVEL_MODERATE" "PRICE_LEVEL_EXPENSIVE" "PRICE_LEVEL_VERY_EXPENSIVE" Przykład: ["PRICE_LEVEL_MODERATE","PRICE_LEVEL_EXPENSIVE"]
business_status	Określa stan firmy, który należy uwzględnić. Możesz określić wiele stanów firmy.	ARRAY<STRING>	Obsługiwane wartości: "OPERATIONAL" "CLOSED_TEMPORARILY" "CLOSED_PERMANENTLY" "FUTURE_OPENING" Przykład: ["OPERATIONAL","CLOSED_TEMPORARILY"]
takeout	Uwzględnia miejsca, które oferują dania na wynos.	BOOLEAN	TRUE, FALSE
delivery	Uwzględnia miejsca, które oferują dostawę.	BOOLEAN	TRUE, FALSE
dine_in	Uwzględnia miejsca, w których można zjeść posiłek.	BOOLEAN	TRUE, FALSE
curbside_pickup	Uwzględnia miejsca, które oferują odbiór na zewnątrz.	BOOLEAN	TRUE, FALSE
reservable	Zastanów się nad miejscami, które można zarezerwować.	BOOLEAN	TRUE, FALSE
outdoor_seating	Uwzględnia miejsca, które oferują stoliki na zewnątrz.	BOOLEAN	TRUE, FALSE
live_music	Uwzględnia miejsca, w których można słuchać muzyki na żywo.	BOOLEAN	TRUE, FALSE
allows_dogs	Rozważ miejsca, w których można przebywać z psami.	BOOLEAN	TRUE, FALSE
restroom	Uwzględnia miejsca, w których są toalety.	BOOLEAN	TRUE, FALSE
serves_breakfast	Uwzględnia miejsca, w których można zjeść śniadanie.	BOOLEAN	TRUE, FALSE
serves_lunch	Uwzględnia miejsca, w których można zjeść obiad.	BOOLEAN	TRUE, FALSE
serves_dinner	Uwzględnia miejsca, w których można zjeść kolację.	BOOLEAN	TRUE, FALSE
serves_beer	Uwzględnia miejsca, w których można napić się piwa.	BOOLEAN	TRUE, FALSE
serves_wine	Uwzględnia miejsca, w których można napić się wina.	BOOLEAN	TRUE, FALSE
serves_brunch	Uwzględnia miejsca, w których można zjeść brunch.	BOOLEAN	TRUE, FALSE
serves_vegetarian_food	Uwzględnia miejsca, które serwują dania wegetariańskie.	BOOLEAN	TRUE, FALSE
serves_cocktails	Uwzględnia miejsca, w których serwowane są koktajle.	BOOLEAN	TRUE, FALSE
serves_dessert	Uwzględnia miejsca, w których można zjeść deser.	BOOLEAN	TRUE, FALSE
serves_coffee	Uwzględnia miejsca, w których można napić się kawy.	BOOLEAN	TRUE, FALSE
menu_for_children	Uwzględnia miejsca, które oferują menu dla dzieci.	BOOLEAN	TRUE, FALSE
good_for_children	Zastanów się nad miejscami, które są odpowiednie dla dzieci.	BOOLEAN	TRUE, FALSE
good_for_groups	Zastanów się nad miejscami, które są odpowiednie dla grup.	BOOLEAN	TRUE, FALSE
good_for_watching_sports	Weź pod uwagę miejsca, które są dobre do oglądania sportu.	BOOLEAN	TRUE, FALSE
accepts_credit_cards	Rozważ miejsca, w których można płacić kartą kredytową.	BOOLEAN	TRUE, FALSE
accepts_debit_cards	Weź pod uwagę miejsca, które akceptują karty debetowe.	BOOLEAN	TRUE, FALSE
accepts_cash_only	Uwzględnij miejsca, w których można płacić tylko gotówką.	BOOLEAN	TRUE, FALSE
accepts_nfc	Zwróć uwagę na miejsca, które akceptują płatności NFC.	BOOLEAN	TRUE, FALSE
free_parking_lot	Uwzględnia miejsca, które mają bezpłatny parking.	BOOLEAN	TRUE, FALSE
paid_parking_lot	Uwzględnia miejsca, które mają płatny parking.	BOOLEAN	TRUE, FALSE
free_street_parking	Uwzględnia miejsca, które mają bezpłatny parking przy ulicy.	BOOLEAN	TRUE, FALSE
paid_street_parking	Uwzględnia miejsca, które mają płatny parking przy ulicy.	BOOLEAN	TRUE, FALSE
valet_parking	Uwzględnia miejsca, które oferują parking z obsługą.	BOOLEAN	TRUE, FALSE
free_garage_parking	Uwzględnia miejsca, które mają bezpłatny parking zadaszony.	BOOLEAN	TRUE, FALSE
paid_garage_parking	Uwzględnia miejsca, które mają płatny parking zadaszony.	BOOLEAN	TRUE, FALSE
wheelchair_accessible_parking	Uwzględnia miejsca, które mają parking dostępny dla osób na wózkach.	BOOLEAN	TRUE, FALSE
wheelchair_accessible_entrance	Uwzględnia miejsca, które mają wejście dostępne dla osób na wózkach.	BOOLEAN	TRUE, FALSE
wheelchair_accessible_restroom	Uwzględnia miejsca, które mają toaletę dostępną dla osób na wózkach.	BOOLEAN	TRUE, FALSE
wheelchair_accessible_seating	Uwzględnia miejsca, które mają miejsca dla osób na wózkach.	BOOLEAN	TRUE, FALSE
snapshot_date	Określa miesiąc historycznego zrzutu, którego dotyczy zapytanie. Jeśli zostanie pominięty, domyślnie używany jest najnowszy zrzut.	STRING	Format: YYYY-MM. Przykład: "2026-07"
month1	Tylko dla: PLACES_COUNT_CHANGE Określa miesiąc zrzutu podstawowego, którego dotyczy zapytanie.	STRING	Format: YYYY-MM. Przykład: "2026-01"
month2	Tylko dla: PLACES_COUNT_CHANGE Określa miesiąc, którego ma dotyczyć zapytanie dotyczące porównania.	STRING	Format: YYYY-MM. Przykład: "2026-02"
regular_opening_hours	Filtruje miejsca według ich zwykłych godzin otwarcia.	JSON	Przykład: JSON_OBJECT('monday', [JSON_OBJECT('start_time', '09:00', 'end_time', '12:00')])
min_ev_charge_connector_count	Określa minimalną liczbę złączy do ładowania pojazdów elektrycznych.	INT64	Minimalna wartość to 0.
max_ev_charge_connector_count	Określa maksymalną liczbę złączy do ładowania pojazdów elektrycznych.	INT64	Minimalna wartość to 0.
max_ev_max_charge_rate_kw	Określa maksymalną moc ładowania w kW na stacjach ładowania EV.	FLOAT64	Minimalna wartość to 0,0.
ev_charge_connector_types	Określa typy złączy EV, które należy uwzględnić.	ARRAY<STRING>	Przykład: ["EV_CONNECTOR_TYPE_TESLA"]