L'endpoint history fornisce
informazioni storiche orarie sulla qualità dell'aria per una località specifica, per un determinato
intervallo di tempo, fino a un massimo di 30 giorni. Puoi controllare quali indici di qualità dell'aria e
informazioni pertinenti vengono restituiti (ad esempio il livello di concentrazione degli inquinanti e
consigli per la salute).
Puoi richiedere la cronologia della qualità dell'aria oraria utilizzando l'endpoint
history inviando una richiesta HTTP POST a:
https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY
Includi le opzioni della richiesta nel corpo della richiesta JSON. Il corpo della richiesta contiene la posizione e l'intervallo di tempo per cui vuoi ottenere la cronologia oraria della qualità dell'aria. Potrebbe anche includere varie opzioni per controllare quali informazioni sulla qualità dell'aria includere nella risposta.
L'Explorer API ti consente di effettuare richieste in tempo reale per familiarizzare con l'API e le relative opzioni:
Esempio di richiesta di una sola ora
Corpo della richiesta di una sola ora
Il codice seguente mostra come creare un corpo della richiesta per una richiesta della cronologia di una sola ora utilizzando il metodo history.
In questo esempio, imposti la posizione e il timestamp passato.
curl -X POST -d '{
"dateTime": "2023-06-26T15:01:23Z",
"location": {
"latitude": 37.419734,
"longitude": -122.0827784
}
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'
Risposta entro 1 ora
La chiamata precedente genera la seguente risposta JSON. Per maggiori dettagli sui dati di risposta, consulta Dati di risposta.
{ "hoursInfo": [ { "dateTime": "2023-06-26T15:00:00Z", "indexes": [ { "code": "uaqi", "displayName": "Universal AQI", "aqi": 73, "aqiDisplay": "73", "color": { "red": 118, "green": 202, "blue": 51, "alpha": 255 }, "category": "Good air quality", "dominantPollutant": "pm10" } ] } ], "regionCode": "us" }
Esempio di richiesta di intervallo di tempo
Richiesta di intervallo di tempo
Il seguente codice mostra come costruire un corpo della richiesta per un
history che restituisce più
record di qualità dell'aria oraria storica.
Puoi richiedere più record specificando un intervallo di tempo, ovvero un timestamp di inizio e fine, oppure specificando il numero di ore a partire dall'ora corrente.
Nell'esempio riportato di seguito, poiché hai impostato la dimensione della pagina su 2, la tua richiesta di
quattro ore di cronologia della qualità dell'aria viene restituita in due pagine, ognuna delle quali
contiene due ore di dati.
curl -X POST -d '{
"hours": 4,
"pageSize": 2,
"pageToken":"",
"location": {
"latitude": 37.419734,
"longitude": -122.0827784
}
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'
Puoi effettuare una richiesta simile passando i timestamp di inizio e fine:
curl -X POST -d '{
"period": {
"startTime":"2023-06-15T08:00:00Z",
"endTime":"2023-06-15T12:00:00Z"
},
"pageSize": 2,
"pageToken":"",
"location": {
"latitude": 37.419734,
"longitude": -122.0827784
}
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'
Risposta all'intervallo di tempo
Le chiamate precedenti generano una risposta JSON nel formato riportato di seguito. Per maggiori dettagli sui dati di risposta, vedi Dati di risposta.
Entrambe le chiamate precedenti richiedono quattro ore di dati sulla qualità dell'aria. Tuttavia, poiché nella richiesta hai impostato
la proprietà pageSize su 2, la risposta include solo
i risultati delle ultime due ore.
{ "hoursInfo": [ { "dateTime": "2023-06-15T11:00:00Z", "indexes": [ { "code": "uaqi", "displayName": "Universal AQI", "aqi": 83, "aqiDisplay": "83", "color": { "red": 74, "green": 185, "blue": 54, "alpha": 255 }, "category": "Excellent air quality", "dominantPollutant": "o3" } ] }, { "dateTime": "2023-06-15T10:00:00Z", "indexes": [ { "code": "uaqi", "displayName": "Universal AQI", "aqi": 89, "aqiDisplay": "89", "color": { "red": 48, "green": 175, "blue": 55, "alpha": 255 }, "category": "Excellent air quality", "dominantPollutant": "o3" } ] } ], "regionCode": "us", "nextPageToken": "ChYaEgl3gv3XubVCQBEsNMY9TTdUMTE6MDA6MDA" }
Tieni presente che la risposta include anche la proprietà nextPageToken. Utilizza questa proprietà per accedere alla pagina successiva dei risultati, che contiene i dati delle due ore successive.
Per accedere alla pagina successiva dei risultati, effettua una seconda richiesta all'endpoint
history, ma questa volta imposta la proprietà pageToken sul valore di
nextPageToken della prima risposta.
curl -X POST -d '{
"hours": 4,
"pageSize": 2,
"pageToken":"ChYaEgl3gv3XubVCQBEsNMY9TTdUMTE6MDA6MDA",
"location": {
"latitude": 37.419734,
"longitude": -122.0827784
}
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'
Prova
L'Explorer API ti consente di effettuare richieste di esempio per familiarizzare con l'API e le relative opzioni.
Seleziona l'icona API api sul lato destro della pagina.
(Facoltativo) Modifica i parametri della richiesta.
Seleziona il pulsante Esegui. Nella finestra di dialogo, scegli l'account che vuoi utilizzare per effettuare la richiesta.
Nel riquadro Explorer API, seleziona l'icona a schermo intero fullscreen per espandere la finestra di Explorer API.