Realiza tu primera solicitud

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 los lugares coincidentes.

Pruébalo

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

Proporciona parámetros de región y tipo en el cuerpo JSON para definir mejor tu solicitud. En este ejemplo, se muestra una solicitud para devolver el recuento de restaurantes en San Francisco que están operativos, tienen precios moderados 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 ejemplo para que te familiarices con la API y sus opciones.

1. Selecciona el ícono de la API, , en el lado derecho de la página.
2. De manera opcional, expande Mostrar parámetros estándar para establecer cualquier parámetro.
3. De manera opcional, edita el cuerpo de la solicitud.
4. Selecciona el botón Ejecutar. En el diálogo, elige la cuenta que deseas usar para realizar la solicitud.

5. En el panel del Explorador de APIs, selecciona el ícono de expansión, , para expandir la ventana del Explorador de APIs.

¿Qué sigue?

• Explora más ejemplos de lo que puedes lograr con la API de Places Aggregate.
• Analicemos los parámetros de solicitud con más detalle.
• Consulta la documentación completa de la API.