En este documento, se explica cómo realizar una solicitud básica a la API de Places Aggregate y comprender la respuesta, que incluye un recuento de lugares coincidentes.
Para usar la API de Places Aggregate, envía una solicitud HTTP POST al extremo computeInsights
de la siguiente manera:
https://areainsights.googleapis.com/v1:computeInsights
Para definir mejor tu solicitud, proporciona parámetros de región y tipo en el cuerpo JSON. En este ejemplo, se muestra una solicitud para mostrar el recuento de restaurantes en San Francisco que están en funcionamiento, tienen un precio moderado y tienen una calificación de entre 4 y 5 estrellas.
curl --location 'https://areainsights.googleapis.com/v1:computeInsights' \ --header 'X-Goog-Api-Key: API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "insights":[ "INSIGHT_COUNT" ], "filter":{ "locationFilter":{ "region":{ "place":"places/ChIJIQBpAG2ahYAR_6128GcTUEo" } }, "typeFilter":{ "includedTypes":[ "restaurant" ] }, "operatingStatus":[ "OPERATING_STATUS_OPERATIONAL" ], "priceLevels":[ "PRICE_LEVEL_INEXPENSIVE" ], "ratingFilter":{ "minRating":4.0, "maxRating":5.0 } } }'
Respuesta de la API de Places Aggregate
La siguiente respuesta de la solicitud de ejemplo anterior muestra el recuento de restaurantes que coinciden con los criterios.
{ "count": "850" }
Pruébalo
El Explorador de APIs te permite realizar solicitudes de muestra para que te familiarices con la API y sus opciones.
- Selecciona el ícono de API,
, en el lado derecho de la página.
- De manera opcional, expande Mostrar parámetros estándar para configurar cualquier parámetro.
- De manera opcional, edita el Cuerpo de la solicitud.
- Selecciona el botón Ejecutar. En el cuadro de diálogo, elige la cuenta que deseas usar para realizar la solicitud.
En el panel del Explorador de API, selecciona el ícono de expansión,
, para expandir la ventana del Explorador de API.
¿Qué sigue?
- Explora más ejemplos de lo que puedes lograr con la API de Places Aggregate.
- Consulta los parámetros de solicitud con más detalle.
- Consulta la documentación completa de la API.