W interfejsie Places Aggregate API filtr typu pomaga zawęzić wyszukiwanie, umożliwiając wybór typów miejsc, które mają być uwzględnione w odpowiedzi lub z niej wykluczone. Możesz tworzyć listy typów, które Cię interesują, i typów, które Cię nie interesują. Dotyczy to zarówno głównej kategorii miejsca, jak i innych szczegółów. W ten sposób możesz tworzyć konkretne wyszukiwania, aby znaleźć dokładnie te miejsca, których szukasz.
Dostępnych jest ponad 200 typów miejsc. Pełną listę obsługiwanych typów znajdziesz w tabeli A w sekcji Typy miejsc w artykule o Places API (nowym).
Jak działają typy miejsc
Miejsce może mieć wiele typów:
Miejsce może mieć jeden główny typ, który odzwierciedla jego podstawową funkcję. W niektórych przypadkach typ podstawowy może nie być określony dla danego miejsca.
Miejsce może mieć co najmniej jeden dodatkowy typ. Dodatkowe typy to dodatkowe kategorie, które można przypisać do miejsca, aby dostarczyć dodatkowych informacji o jego cechach i usługach.
Na przykład miejsce może określić swój główny typ jako restaurant
, ale ponieważ pełni też funkcję baru i oferuje usługi gastronomiczne, może też określić swoje dodatkowe typy jako bar, food
i establishment
.
Filtruj według typu:
Aby filtrować miejsca według głównego typu, użyj w żądaniu parametrów includedPrimaryTypes
i excludedPrimaryTypes
. Filtr dotyczy tylko głównego typu miejsca. Na przykład filtr includedPrimaryTypes
dla restaurant
zwraca tylko miejsca, które pełnią głównie funkcję restauracji.
Aby filtrować miejsca według głównego i dodatkowego typu, użyj w żądaniu znaków
includedTypes
i excludedTypes
. Filtr ma zastosowanie do obu typów. Na przykład includedTypes
o wartości bar
zwraca miejsca, które mają bar
jako podstawowy lub dodatkowy typ.