Effettua la tua prima richiesta

Questo documento illustra come effettuare una richiesta di base all'API Places Aggregate e come interpretare la risposta, che include un conteggio dei luoghi corrispondenti.

Prova!

Per utilizzare l'API Places Aggregate, invia una richiesta HTTP POST all'endpoint computeInsights come segue:

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

Perfeziona la richiesta fornendo i parametri region e type nel corpo JSON. Questo esempio mostra una richiesta per restituire il conteggio dei ristoranti a San Francisco che sono operativi, con prezzi moderati e con una valutazione compresa tra 4 e 5 stelle.

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

Risposta dell'API Places Aggregate

La seguente risposta alla richiesta di esempio riportata sopra mostra il conteggio dei ristoranti che corrispondono ai criteri.

{
  "count": "850"
}

Prova

L'Explorer API ti consente di effettuare richieste di esempio per familiarizzare con l'API e le relative opzioni.

1. Seleziona l'icona dell'API, , sul lato destro della pagina.
2. (Facoltativo) Espandi Mostra parametri standard per impostare i parametri.
3. (Facoltativo) Modifica il corpo della richiesta.
4. Seleziona il pulsante Esegui. Nella finestra di dialogo, scegli l'account che vuoi utilizzare per effettuare la richiesta.

5. Nel riquadro Explorer API, seleziona l'icona di espansione, , per espandere la finestra di Explorer API.

Passaggi successivi

• Esplora altri esempi di ciò che puoi ottenere con l'API Places Aggregate.
• Esamina i parametri di richiesta in modo più dettagliato.
• Visualizza la documentazione completa dell'API.