L'endpoint history fornisce informazioni storiche sulla qualità dell'aria su base oraria per una località specifica, per un determinato intervallo di tempo, fino a un massimo di 30 giorni. Puoi controllare quali AQI e informazioni pertinenti vengono restituiti (ad esempio il livello di concentrazione degli agenti inquinanti e i consigli per la salute).
Puoi richiedere la cronologia della qualità dell'aria oraria utilizzando l'endpoint history inviando una richiesta POST HTTP 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 località 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.
Explorer API ti consente di effettuare richieste in tempo reale per acquisire familiarità con l'API e le relative opzioni:
Esempio di richiesta per un'ora singola
Corpo della richiesta per un'ora singola
Il codice seguente mostra come creare un corpo della richiesta per una richiesta di cronologia di un'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 un'ora
La chiamata precedente genera la seguente risposta JSON. Per maggiori dettagli sui dati della risposta, consulta Dati della 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 creare un corpo della richiesta per un
history che restituisce più
record della qualità dell'aria oraria storica.
Puoi richiedere più record specificando un intervallo di tempo, ovvero un timestamp di inizio e di fine, oppure specificando il numero di ore precedenti rispetto all'ora corrente.
Nell'esempio seguente, 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, dove ogni pagina 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 di 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 sull'intervallo di tempo
Le chiamate riportate sopra generano una risposta JSON nel modulo riportato di seguito. Per maggiori dettagli sui dati della risposta, consulta Dati della risposta.
Entrambe le chiamate riportate sopra 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 relativi alle 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
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.
Se vuoi, modifica i parametri di 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 Schermo intero fullscreen per espandere la finestra di Explorer API.