Więcej informacji o filtrach typów

W interfejsie Places Aggregate API filtr typu pomaga zawęzić wyszukiwanie, umożliwiając wybranie typów miejsc, które chcesz uwzględnić w odpowiedzi lub z niej wykluczyć. Możesz tworzyć listy typów, które Cię interesują, i typów, które Cię nie interesują, zarówno w przypadku głównej kategorii miejsca, jak i jego innych szczegółów. Dzięki temu 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 miejsc znajdziesz w tabeli A w sekcji Typy miejsc w dokumentacji interfejsu Places API (nowego).

Jak działają typy miejsc

Miejsce może mieć kilka typów:

• Miejsce może mieć jeden typ podstawowy, który odzwierciedla jego główną funkcję. W niektórych przypadkach typ podstawowy może nie być określony.

• Miejsce może mieć co najmniej 1 typ dodatkowy. Typy dodatkowe to dodatkowe kategorie, które mają zastosowanie do miejsca i zawierają dodatkowe informacje o jego cechach i usługach.

Na przykład miejsce może określić swój typ podstawowy jako restaurant, ale ponieważ pełni też funkcję baru i oferuje usługi gastronomiczne, może też określić swoje typy dodatkowe jako bar, food i establishment.

Filtruj według typu

Aby filtrować miejsca według typu podstawowego, użyj w żądaniu parametrów includedPrimaryTypes i excludedPrimaryTypes. Filtr ma zastosowanie tylko do typu podstawowego miejsca. Na przykład filtr includedPrimaryTypes z wartością restaurant zwraca tylko miejsca, które pełnią głównie funkcję restauracji.

Aby filtrować miejsca według typu podstawowego i dodatkowego, użyj w żądaniu parametrów includedTypes i excludedTypes. Filtr ma zastosowanie do obu typów. Na przykład includedTypes z bar zwraca miejsca, które mają bar jako typ podstawowy lub dodatkowy.

Uwaga: interfejs API korzysta z hierarchicznego systemu typów. Określenie typu w filtrze automatycznie obejmuje wszystkie jego elementy podrzędne (podtypy). Jeśli na przykład w parametrze includedPrimaryTypes podasz wartość gym, wyniki będą też zawierać miejsca z typem podstawowym yoga_studio, ponieważ jest to podtyp siłowni.

Ważne: w przypadku używania wielu filtrów ważne jest, aby zrozumieć, jak one ze sobą współdziałają. W szczególności miejsca są oceniane za pomocą operatora logicznego LUB w ramach tego samego filtra i operatora logicznego ORAZ w przypadku różnych filtrów.

• W ramach filtra (operator logiczny LUB): na przykład includedTypes: restaurant, bar oznacza, że miejsce może być restaurant lub bar.
• W przypadku różnych filtrów (operator logiczny ORAZ): wszystkie określone kryteria filtra muszą być spełnione jednocześnie. Oznacza to, że każdy filtr dodaje do zapytania warstwę ograniczeń, a w wynikach zostaną uwzględnione tylko miejsca, które spełniają wszystkie warunki.

Jeśli na przykład ustawisz includedTypes: restaurant, bar i excludedTypes: hotel, najpierw filtr includedTypes wybierze wszystkie miejsca, które są sklasyfikowane jako restaurant lub bar. Następnie filtr excludedTypes usunie z tego wyboru wszystkie miejsca, które są też sklasyfikowane jako hotel. W rezultacie zapytanie zwróci miejsca, które są restaurant lub bar, ale tylko wtedy, gdy nie są też sklasyfikowane jako hotel w żadnym z typów (podstawowym lub dodatkowym).