В API Places Aggregate фильтр по типу помогает сузить поиск, позволяя выбирать, какие типы мест вы хотите включить в ответ, а какие исключить. Вы можете создавать списки нужных и ненужных типов как для основной категории места, так и для других его характеристик. Таким образом, вы можете создавать конкретные поисковые запросы, чтобы найти именно те места, которые вам нужны.
Доступно более 200 типов мест. Полный список поддерживаемых API Places Aggregate см. в таблице A в разделе « Типы мест для Places API (новые)».
Как работают типы мест
Одно место может иметь несколько типов:
Место может иметь один основной тип , отражающий его основную функцию. Однако в некоторых случаях основной тип для места может быть не указан.
Место может иметь один или несколько вторичных типов. Вторичные типы — это дополнительные категории, которые применяются к месту для предоставления дополнительной информации о его характеристиках и услугах.
Например, заведение может указать свой основной тип как restaurant , но поскольку оно также служит баром и предоставляет услуги питания, оно может указать и второстепенные типы как bar, food и establishment .
Фильтр по типу
Для фильтрации заведений по основному типу используйте в запросе includedPrimaryTypes и excludedPrimaryTypes . Фильтр применяется только к основному типу заведения. Например, фильтр includedPrimaryTypes для restaurant возвращает только те заведения, которые в основном функционируют как рестораны.
Чтобы отфильтровать места по основному и дополнительному типам, используйте в запросе includedTypes и excludedTypes . Фильтр применяется к обоим типам. Например, атрибут includedTypes со значением bar вернет места, у которых bar является либо основным, либо дополнительным типом.