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

Para refinar 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 operativos, tienen precios moderados y 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 cumplen con los criterios.

{
  "count": "850"
}

Pruébalo

El Explorador de API te permite realizar solicitudes de muestra para que puedas familiarizarte 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 parámetros.
3. También puedes editar el cuerpo de la solicitud.
4. Selecciona el botón Ejecutar. En el cuadro de diálogo, elige la cuenta que deseas usar para realizar la solicitud.

5. 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.