Parametry filtra

Do funkcji zliczania miejsc 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:

Jeśli nazwa i wartość filtra nie są określone zgodnie z wymaganiami poniżej, funkcja zwraca błąd nieprawidłowego argumentu.

Nazwa filtra Opis Typ Obsługiwane wartości
geography

W przypadku PLACES_COUNT, PLACES_COUNT_PER_TYPEPLACES_COUNT_PER_H3

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

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

Obowiązuje minimalny obszar wyszukiwania o wymiarach 40,0 m × 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 PLACES_COUNT_PER_GEO

Określa listę obszarów, w których ma zostać przeprowadzone wyszukiwanie. Obsługiwany jest każdy typ GEOGRAPHY, np. Point, LineStringPolygon.

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 o wymiarach 40,0 m × 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 do określonego obszaru promień lub bufor w metrach. Wartością domyślną jest 0.

Określona wartość musi definiować minimalny obszar wyszukiwania o wymiarach 40,0 m × 40,0 m (1600 m2). Na przykład w przypadku Point minimalny promień wynosi 23 metry.

INT64 Minimalna wartość to 0.
h3_resolution

Tylko w przypadku PLACES_COUNT_PER_H3

Rozdzielczość H3 używana do agregowania liczby miejsc w komórkach H3.

INT64 Od 0 do 8.
types

Określa typy miejsc, które należy uwzględnić.

Każde miejsce zawiera zestaw typów miejsc, np. "restaurant""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 tabelach A i B w artykule Typy miejsc.

Przykład:

["restaurant", "cafe", "bar"]

primary_types

Określa główne typy, które należy uwzględnić.

Miejsce może mieć tylko jeden typ podstawowy, który najlepiej je opisuje.

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

ARRAY<STRING>

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

Przykład:

["restaurant", "cafe", "bar"]

min_rating Określa minimalną ocenę miejsca, która ma być brana pod uwagę.

Ocena miejsca jest obliczana na podstawie opinii 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 obliczana na podstawie opinii 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 należy wziąć pod uwagę.

Liczba ocen użytkowników to łączna liczba opinii o danym 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 danym 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 wziąć pod uwagę.

Możesz określić wiele poziomów cenowych.

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ć brany pod uwagę. Możesz określić wiele stanów firmy. ARRAY<STRING>

Obsługiwane wartości:

"OPERATIONAL"

"CLOSED_TEMPORARILY"

"CLOSED_PERMANENTLY"

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 Rozważ miejsca, które można zarezerwować. BOOLEAN TRUE, FALSE
outdoor_seating Uwzględnia miejsca, w których można usiąść na zewnątrz. BOOLEAN TRUE, FALSE
live_music Uwzględnia miejsca, w których można posłuchać muzyki na żywo. BOOLEAN TRUE, FALSE
allows_dogs Wybieraj 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 serwowane są śniadania. 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 serwowane jest piwo. BOOLEAN TRUE, FALSE
serves_wine Uwzględnia miejsca, w których podaje się wino. BOOLEAN TRUE, FALSE
serves_brunch Uwzględnia miejsca, w których można zjeść brunch. BOOLEAN TRUE, FALSE
serves_vegetarian_food uwzględnia miejsca, w których można zjeść 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ę, które miejsca są odpowiednie dla dzieci. BOOLEAN TRUE, FALSE
good_for_groups Wybieraj miejsca odpowiednie dla grup. BOOLEAN TRUE, FALSE
good_for_watching_sports Weź pod uwagę miejsca, w których można oglądać sport. BOOLEAN TRUE, FALSE
accepts_credit_cards Wybieraj miejsca, w których można płacić kartą kredytową. BOOLEAN TRUE, FALSE
accepts_debit_cards Wybieraj miejsca, w których można płacić kartą debetową. BOOLEAN TRUE, FALSE
accepts_cash_only Weź pod uwagę miejsca, w których można płacić tylko gotówką. BOOLEAN TRUE, FALSE
accepts_nfc Wybierz miejsca, w których akceptowane są 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, w których jest bezpłatny parking przy ulicy. BOOLEAN TRUE, FALSE
paid_street_parking Uwzględnia miejsca, w których jest płatny parking przy ulicy. BOOLEAN TRUE, FALSE
valet_parking Uwzględnia miejsca, w których jest 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 z płatnym parkingiem zadaszonym. 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 z wejściem dla osób na wózkach inwalidzkich. 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 z miejscami dla osób na wózkach. BOOLEAN TRUE, FALSE