Faça sua primeira solicitação

Este documento orienta você na criação de uma solicitação básica para a API Places Aggregate e na compreensão da resposta, que inclui uma contagem de lugares correspondentes.

Faça um teste

Para usar a API Places Aggregate, envie uma solicitação HTTP POST para o endpoint computeInsights da seguinte maneira:

https://areainsights.googleapis.com/v1:computeInsights

Refine sua solicitação fornecendo parâmetros de região e tipo no corpo JSON. Este exemplo mostra uma solicitação para retornar a contagem de restaurantes em São Francisco que estão em funcionamento, têm preços moderados e são classificados entre 4 e 5 estrelas.

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
      }
   }
}'

Resposta da API Places Aggregate

A resposta a seguir da solicitação de exemplo acima mostra a contagem de restaurantes que correspondem aos critérios.

{
  "count": "850"
}

Confira!

Com o API Explorer, é possível fazer solicitações de amostra para se familiarizar com a API e as opções dela.

  1. Selecione o ícone da API, Expanda o API Explorer., no lado direito da página.
  2. Se quiser, abra Mostrar parâmetros padrão para definir qualquer parâmetro.
  3. Se quiser, edite o corpo da solicitação.
  4. Selecione o botão Executar. Na caixa de diálogo, escolha a conta que você quer usar para fazer a solicitação.

  5. No painel do API Explorer, selecione o ícone de expansão, Expanda o API Explorer., para abrir a janela do API Explorer.

A seguir