La API de Places Aggregate es un servicio que proporciona estadísticas sobre lugares dentro de un área especificada según criterios como la ubicación, el tipo, el estado operativo, el nivel de precios y las calificaciones de los usuarios. Este servicio puede ayudar a analizar la densidad de tipos de lugares específicos alrededor de una ubicación determinada y responder preguntas como "¿Qué restaurantes de $$$ con calificación de 5 estrellas hay en un radio de 5 km de esta ubicación?" o "¿Cuántos hay?".
Los resultados se muestran como recuentos agregados o como los IDs de lugar identificados en el área de interés de la búsqueda. Los usuarios pueden usar la API de Place Details para recuperar más información sobre esos IDs de lugar.
Por qué usar la API de Places Aggregate
La API de Places Aggregate permite a los usuarios tomar decisiones basadas en datos a partir de la información integral que proporcionas sobre varios lugares. Aprovecha modelos de lugares precisos y actualizados, lo que admite los siguientes casos de uso clave:
- Empresas: Analiza la competencia y las posibles ubicaciones para nuevas sucursales.
- Desarrolladores: Compilan aplicaciones que proporcionan recomendaciones personalizadas.
- Investigadores: Pueden examinar tendencias y patrones en áreas específicas.
Qué puedes hacer con la API de Places Aggregate
Con la API de Places Aggregate, puedes obtener la siguiente información:
- Recuentos: Recupera la cantidad de lugares que coinciden con tus criterios.
- IDs de lugares: Recupera los IDs de lugares de lugares específicos que coincidan con tus criterios.
También puedes usar filtros para definir mejor tu búsqueda según varios atributos, como tipos de lugares, horarios de atención, niveles de precios y calificaciones de los clientes.
Ejemplos
En esta sección, se describen ejemplos de casos de uso de la API de Places Aggregate y se incluye código funcional para cada ejemplo.
Abrir una cafetería nueva
El propietario de un restaurante quiere abrir una cafetería nueva. Para ello, primero quieren visualizar dónde se encuentran los puntos conflictivos de las cafeterías para identificar las áreas de alta y baja concentración y, así, tomar una decisión comercial fundamentada. La API de Places Aggregate puede ayudar a analizar la cantidad de cafeterías dentro de un radio específico según atributos como el estado de operación, los niveles de precios y las calificaciones de los clientes para tomar una decisión respaldada por datos sobre dónde abrir la próxima ubicación.
Empresa de inversión en bienes raíces
Una empresa de inversión inmobiliaria quiere mejorar sus modelos financieros y determinar con precisión el ROI de sus inversiones inmobiliarias planificadas. Con la API de Places Aggregate, pueden recopilar datos detallados sobre los servicios cercanos a las posibles propiedades de inversión, como cajeros automáticos, hospitales, estaciones de transporte público y supermercados, para comprender los servicios cercanos a las posibles propiedades de inversión.
Servicio de entrega minorista
Cuando se expande a una nueva ciudad, un servicio de entrega minorista debe determinar la cantidad de conductores de entrega que se asignarán a una región en función de la densidad de los destinos populares para los consumidores, como restaurantes, tiendas de conveniencia y licorerías. Con la API, el servicio de entrega cuenta la cantidad total de estos establecimientos en toda la ciudad para poder planificar y asignar recursos de manera eficaz.
Cómo funciona la API de Places Aggregate
La API de Places Aggregate te permite especificar filtros para acotar tus criterios de búsqueda.
Después de seleccionar un Tipo de estadísticas de INSIGHT_COUNT o INSIGHT_PLACES, puedes agregar criterios de filtro, incluidos los siguientes:
- Ubicación: Define el área de interés con círculos, regiones o polígonos personalizados.
- Tipo: Especifica los tipos de lugares que te interesan.
- Estado de las operaciones: Filtra lugares según su estado operativo.
- Niveles de precios: Filtra lugares según los niveles de precios.
- Calificaciones: Filtra lugares según las calificaciones de los usuarios.
El objeto ComputeInsightsResponse de la respuesta de la API contiene los resultados de las estadísticas de la solicitud. Por ejemplo, si seleccionaste INSIGHT_COUNT, la respuesta contiene una cantidad total de lugares y, si seleccionaste INSIGHT_PLACES, la respuesta contiene una lista de IDs de Place.
Cómo usar la API de Places Aggregate
| 1 | Configura tu cuenta. | Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones que se indican a continuación. |
| 2 | Realiza una solicitud para obtener el recuento de lugares coincidentes. | Consulta Realiza tu primera solicitud. |
| 3 | Obtén más información sobre los parámetros de solicitud. | Consulta Parámetros de solicitud. |
¿Qué sigue?
- Revisa los precios y los límites de uso
- Consulta la referencia de la API
- Revisa las preguntas frecuentes
- Revisa las opciones de asistencia