Parametry filtra

Do funkcji zliczających miejsca możesz stosować filtry za pomocą parametrów opisanych w tabeli poniżej. Pamiętaj, że wymagane parametry różnią się w zależności od funkcji:

W nazwie filtra i jego wartości uwzględniana jest wielkość liter. Musisz je podać dokładnie tak, jak są wyświetlane w tabeli. W przeciwnym razie zapytanie zwróci błąd nieprawidłowego argumentu.

Nazwa filtra Opis Typ Obsługiwane wartości
geography

W przypadku funkcji PLACES_COUNT, PLACES_COUNT_PER_TYPE i PLACES_COUNT_PER_H3

Określa obszar wyszukiwania. Obsługiwany jest każdy typ GEOGRAPHY, np. Point, LineString, i Polygon.

Możesz użyć parametru geography w połączeniu z parametrem geography_radius, aby dodać bufor do obszaru wyszukiwania.

Obowiązuje minimalny obszar wyszukiwania wynoszący 40,0 m na 40,0 m (1600 m2). Jeśli określisz obszar wyszukiwania poniżej tego limitu, funkcja zwróci błąd nieprawidłowego argumentu.

 GEOGRAPHY Dowolny typ GEOGRAPHY.
geographies

Tylko w przypadku funkcji PLACES_COUNT_PER_GEO

Określa listę obszarów wyszukiwania. Obsługiwany jest każdy typ GEOGRAPHY, np. Point, LineString, i Polygon.

Możesz użyć parametru geographies w połączeniu z parametrem geography_radius, aby dodać bufor do obszaru wyszukiwania. Bufor jest dodawany do wszystkich określonych obszarów geograficznych.

Obowiązuje minimalny obszar wyszukiwania wynoszący 40,0 m na 40,0 m (1600 m2). 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.

Określona wartość musi definiować minimalny obszar wyszukiwania wynoszący 40,0 m na 40,0 m (1600 m2). Na przykład w przypadku obszaru geograficznego Point minimalny promień wynosi 23 metry.

 INT64 Minimalna wartość to 0.
h3_resolution

Tylko w przypadku funkcji 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, np. "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_types

Określa typy podstawowe, które mają być uwzględniane.

Miejsce może mieć tylko 1 typ podstawowy, który najlepiej opisuje lokalizację.

Jeśli nie określisz żadnych typów podstawowych, w wyniku zostaną uwzględnione wszystkie typy podstawowe miejsc.

 ARRAY<STRING>

Pełną listę możliwych wartości znajdziesz w artykule Typy miejsc.

Przykład:

["restaurant", "cafe", "bar"]
min_rating Określa minimalną ocenę miejsca, która ma być uwzględniana.

Ocena Miejsc opiera się na opiniach użytkowników o miejscu i mieści się w zakresie od 1,0 do 5,0.

Jeśli określisz 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ć uwzględniana.

Ocena Miejsc opiera się na opiniach użytkowników o miejscu i mieści się w zakresie od 1,0 do 5,0.

Jeśli określisz 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óra ma być uwzględniana.

Liczba ocen użytkowników to łączna liczba opinii o miejscu.

Minimalna wartość to 0. Jeśli określisz 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óra ma być uwzględniana.

Liczba ocen użytkowników to łączna liczba opinii o miejscu.

Minimalna wartość to 0. Jeśli określisz 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 mają być uwzględniane.

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 ma być uwzględniany. Możesz określić kilka 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, które oferują posiłki na miejscu. BOOLEAN TRUE, FALSE
curbside_pickup Uwzględnia miejsca, które oferują odbiór na zewnątrz. BOOLEAN TRUE, FALSE
reservable Uwzględnia miejsca, w których można dokonać rezerwacji. BOOLEAN TRUE, FALSE
outdoor_seating Uwzględnia miejsca, które oferują miejsca na zewnątrz. BOOLEAN TRUE, FALSE
live_music Uwzględnia miejsca, które oferują muzykę na żywo. BOOLEAN TRUE, FALSE
allows_dogs Uwzględnia miejsca, w których można przebywać z psami. BOOLEAN TRUE, FALSE
restroom Uwzględnia miejsca, które oferują toalety. BOOLEAN TRUE, FALSE
serves_breakfast Uwzględnia miejsca, które serwują śniadania. BOOLEAN TRUE, FALSE
serves_lunch Uwzględnia miejsca, które serwują obiady. BOOLEAN TRUE, FALSE
serves_dinner Uwzględnia miejsca, które serwują kolacje. BOOLEAN TRUE, FALSE
serves_beer Uwzględnia miejsca, które serwują piwo. BOOLEAN TRUE, FALSE
serves_wine Uwzględnia miejsca, które serwują wino. BOOLEAN TRUE, FALSE
serves_brunch Uwzględnia miejsca, które serwują brunch. BOOLEAN TRUE, FALSE
serves_vegetarian_food Uwzględnia miejsca, które serwują dania wegetariańskie. BOOLEAN TRUE, FALSE
serves_cocktails Uwzględnia miejsca, które serwują koktajle. BOOLEAN TRUE, FALSE
serves_dessert Uwzględnia miejsca, które serwują desery. BOOLEAN TRUE, FALSE
serves_coffee Uwzględnia miejsca, które serwują kawę. BOOLEAN TRUE, FALSE
menu_for_children Uwzględnia miejsca, które oferują menu dla dzieci. BOOLEAN TRUE, FALSE
good_for_children Uwzględnia miejsca, które są odpowiednie dla dzieci. BOOLEAN TRUE, FALSE
good_for_groups Uwzględnia miejsca, które są odpowiednie dla grup. BOOLEAN TRUE, FALSE
good_for_watching_sports Uwzględnia miejsca, które są odpowiednie do oglądania sportu. BOOLEAN TRUE, FALSE
accepts_credit_cards Uwzględnia miejsca, w których można płacić kartą kredytową. BOOLEAN TRUE, FALSE
accepts_debit_cards Uwzględnia miejsca, w których można płacić kartą debetową. BOOLEAN TRUE, FALSE
accepts_cash_only Uwzględnia miejsca, w których można płacić tylko gotówką. BOOLEAN TRUE, FALSE
accepts_nfc Uwzględnia miejsca, w których można płacić za pomocą 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 mają parking z obsługą. BOOLEAN TRUE, FALSE
free_garage_parking Uwzględnia miejsca, które mają bezpłatny parking w garażu. BOOLEAN TRUE, FALSE
paid_garage_parking Uwzględnia miejsca, które mają płatny parking w garażu. 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 dla osób na wózkach. BOOLEAN TRUE, FALSE
wheelchair_accessible_restroom Uwzględnia miejsca, które mają toaletę 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