Más información sobre los filtros de tipos

En la API de Places Aggregate, el filtro de tipo te ayuda a enfocar tu búsqueda, ya que te permite elegir qué tipos de lugares deseas incluir en la respuesta o excluir de ella. Puedes crear listas de los tipos que deseas y los que no deseas, tanto para la categoría principal de un lugar como para sus otros detalles. De esta manera, puedes crear búsquedas específicas para encontrar exactamente los lugares que buscas.

Hay más de 200 tipos de lugares disponibles. Para obtener una lista completa de los tipos que admite la API de Places Aggregate, consulta la Tabla A en Tipos de lugares para la API de Places (nuevo).

Cómo funcionan los tipos de lugares

Un lugar puede tener varios tipos de lugar:

• Un lugar puede tener un solo tipo principal que refleje su función principal. Sin embargo, en algunos casos, es posible que no se especifique el tipo principal de un lugar.

• Un lugar puede tener uno o más tipos secundarios. Los tipos secundarios son categorías adicionales que se aplican a un lugar para proporcionar información complementaria sobre sus características y servicios.

Por ejemplo, un lugar puede especificar su tipo principal como restaurant, pero, como también funciona como bar y ofrece servicios de comida, también puede especificar sus tipos de lugar secundarios como bar, food y establishment.

Filtrar por tipo

Para filtrar lugares por tipo principal, usa includedPrimaryTypes y excludedPrimaryTypes en la solicitud. El filtro solo se aplica al tipo principal de un lugar. Por ejemplo, un filtro includedPrimaryTypes para restaurant solo devuelve lugares que funcionan principalmente como restaurantes.

Para filtrar lugares por los tipos principal y secundario, usa includedTypes y excludedTypes en la solicitud. El filtro se aplica a ambos tipos. Por ejemplo, un includedTypes de bar devuelve lugares que tienen bar como su tipo principal o secundario.

Nota: La API usa un sistema de tipos jerárquico. Si especificas un tipo en tu filtro, se incluirán automáticamente todos sus descendientes (subtipos). Por ejemplo, si solicitas gym en tu includedPrimaryTypes, los resultados también incluyen lugares con el tipo principal yoga_studio, ya que es un subtipo de gimnasio.

Importante: Cuando se usan varios filtros, es importante comprender la interacción entre ellos. En particular, los lugares se evalúan con la lógica OR dentro del mismo filtro y con la lógica AND en diferentes filtros.

• Dentro de un filtro (lógica OR): Por ejemplo, includedTypes: restaurant, bar significa que el lugar puede ser un restaurant o un bar.
• En todos los filtros (lógica AND): Se deben satisfacer todos los criterios de filtro especificados de forma simultánea. Esto significa que cada filtro agrega una capa de restricción a la búsqueda y solo se incluirán en los resultados los lugares que cumplan con todas las condiciones.

Por ejemplo, si configuras includedTypes: restaurant, bar y excludedTypes: hotel, primero el filtro includedTypes seleccionará todos los lugares que se categoricen como restaurant o bar. En segundo lugar, el filtro excludedTypes quitará de esta selección los lugares que también se clasifiquen como hotel. Como resultado, la búsqueda devolverá lugares que sean restaurant o bar, pero solo si no se clasifican también como hotel en ninguno de sus tipos (primario o secundario).