Mais informações sobre filtros de tipo

Na API Places Aggregate, o filtro de tipo ajuda a focar sua pesquisa, permitindo que você escolha quais tipos de lugares quer incluir ou omitir da resposta. Você pode criar listas de tipos que quer e não quer, tanto para a categoria principal de um lugar quanto para os outros detalhes. Assim, você pode criar pesquisas específicas para encontrar exatamente os lugares que está procurando.

Há mais de 200 tipos de lugar disponíveis. Para conferir uma lista completa de tipos de lugar compatíveis com a API Places Aggregate, consulte a Tabela A em Tipos de lugar para a API Places (nova).

Como os tipos de lugar funcionam

Um lugar pode ter vários tipos de lugar:

• Um lugar pode ter um único tipo principal que reflita sua função principal. No entanto, em alguns casos, o tipo principal pode não ser especificado para um lugar.

• Um lugar pode ter um ou mais tipos secundários. Os tipos secundários são categorias adicionais que se aplicam a um lugar para fornecer informações complementares sobre as características e os serviços dele.

Por exemplo, um lugar pode especificar o tipo principal como restaurant, mas, como também serve como bar e oferece serviços de alimentação, também pode especificar os tipos de lugar secundários como bar, food e establishment.

Filtrar por tipo

Para filtrar lugares por tipo principal, use includedPrimaryTypes e excludedPrimaryTypes na solicitação. O filtro só se aplica ao tipo principal de um lugar. Por exemplo, um filtro includedPrimaryTypes para restaurant retorna apenas lugares que funcionam principalmente como restaurantes.

Para filtrar lugares pelos tipos primário e secundário, use includedTypes e excludedTypes na solicitação. O filtro é aplicado a ambos os tipos. Por exemplo, um includedTypes de bar retorna lugares que têm bar como qualquer um dos tipos principal ou secundário.

Importante:ao usar vários filtros, é importante entender a interação entre eles. Em particular, os lugares são avaliados usando a lógica OR no mesmo filtro e a lógica AND em diferentes filtros.

• Em um filtro (lógica OR): por exemplo, includedTypes: restaurant, bar significa que o lugar pode ser restaurant ou bar.
• Em vários filtros (lógica E): todos os critérios de filtro especificados precisam ser atendidos simultaneamente. Isso significa que cada filtro adiciona uma camada de restrição à consulta, e apenas os lugares que atendem a todas as condições são incluídos nos resultados.

Por exemplo, se você definir includedTypes: restaurant, bar e excludedTypes: hotel, o filtro includedTypes vai selecionar todos os lugares categorizados como restaurant ou bar. Em segundo lugar, o filtro excludedTypes remove todos os lugares dessa seleção que também são categorizados como hotel. Como resultado, a consulta vai retornar lugares que são restaurant ou bar, mas apenas se eles não forem classificados como hotel em nenhum dos tipos (primário ou secundário).