En este documento, se explica cómo realizar una solicitud básica a la API de Places Insights y comprender la respuesta, que incluye un recuento de lugares coincidentes.
Para usar Place Insights, 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 Insights
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 y configura los parámetros que desees.
- 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 las estadísticas de Places.
- Consulta los parámetros de solicitud con más detalle.
- Consulta la documentación completa de la API.