Mais informações sobre filtros de tipo

Na API Places Aggregate, o filtro de tipo ajuda você a concentrar sua pesquisa, permitindo escolher quais tipos de lugares 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 outros detalhes. Assim, você pode criar pesquisas específicas para encontrar exatamente os lugares que procura.

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

Como os tipos de lugar funcionam

Um lugar pode ter vários tipos:

• Um lugar pode ter um único tipo principal que reflete 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 funciona como bar e oferece serviços de alimentação, ele 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 se aplica aos dois tipos. Por exemplo, um includedTypes de bar retorna lugares que têm bar como 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 filtros diferentes.

• Em um filtro (lógica OR): por exemplo, includedTypes: restaurant, bar significa que o lugar pode ser um restaurant ou um bar.
• Entre 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 somente os lugares que atendem a todas as condições serão incluídos nos resultados.

Por exemplo, se você definir includedTypes: restaurant, bar e excludedTypes: hotel, primeiro o filtro includedTypes vai selecionar todos os lugares categorizados como restaurant ou bar. Em segundo lugar, o filtro excludedTypes vai remover da seleção todos os lugares que também forem 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 (principal ou secundário).