L'endpoint history
fornisce
informazioni sulla qualità oraria storica dell'aria per una località specifica, per un determinato
intervallo di tempo, fino a un massimo di 30 giorni. Puoi controllare quali IQA e
le informazioni pertinenti vengono restituiti (ad esempio il livello di concentrazione degli inquinanti e
le raccomandazioni sulla 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. Può includere anche varie opzioni per controllare quali informazioni sulla qualità dell'aria includere nella risposta.
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 di cronologia di un'ora utilizzando il metodo history
.
In questo esempio, devi impostare la località 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 singola ora
La chiamata sopra genera la seguente risposta JSON. Per ulteriori dettagli sui dati delle risposte, vedi Dati delle risposte.
{ "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 intervallo di tempo
Il seguente codice mostra come creare un corpo della richiesta per un elemento
history
che restituisce più
record storici della qualità dell'aria oraria.
Puoi richiedere più record specificando un intervallo di tempo, ovvero un timestamp di inizio e fine, oppure specificando il numero di ore indietro rispetto all'ora corrente.
Nell'esempio riportato di seguito, poiché hai impostato le dimensioni della pagina su 2
, la richiesta relativa a
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 inserendo 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 all'intervallo di tempo
Le chiamate sopra riportate generano una risposta JSON nel modulo sottostante. Per ulteriori dettagli sui dati delle risposte, consulta Dati delle risposte.
Entrambe le chiamate indicate sopra richiedono quattro ore di dati sulla qualità dell'aria. Tuttavia, poiché imposti la proprietà pageSize
su 2
nella richiesta, 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" }
Nota 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 dei risultati successiva, effettua una seconda richiesta all'endpoint history
, ma questa volta imposta la proprietà pageToken
sul valore nextPageToken
dalla 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'