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 IQA e informazioni pertinenti vengono restituiti (ad esempio il livello di concentrazione degli 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 di richiesta nel corpo della richiesta JSON. Il corpo della richiesta contiene la località e l'intervallo di tempo per cui vuoi ottenere la cronologia della qualità dell'aria oraria. 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 consentirti di acquisire familiarità con l'API e le relative opzioni:
Esempio di richiesta di un'ora
Corpo della richiesta per una singola ora
Il seguente codice mostra come creare un corpo della richiesta per una singola richiesta di cronologia di un'ora utilizzando il metodo history
.
In questo esempio, imposti la posizione e il timestamp precedente.
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 riportata sopra genera la seguente risposta JSON. Per ulteriori 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 codice seguente 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 iniziale e finale, oppure specificando il numero di ore precedenti all'ora corrente.
Nell'esempio riportato di seguito, poiché hai impostato la dimensione della pagina su 2
, la richiesta di quattro ore di cronologia della qualità dell'aria viene restituita in due pagine, ciascuna contenente 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 intervallo di tempo
Le chiamate precedenti generano una risposta JSON nel modulo di seguito. Per ulteriori dettagli sui dati di risposta, consulta Dati di risposta.
Entrambe le chiamate precedenti richiedono dati sulla qualità dell'aria di quattro ore. Tuttavia, poiché hai impostato la proprietà pageSize
su 2
nella richiesta, la risposta include solo i risultati delle due ore più recenti.
{ "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 le due ore di dati successive.
Per accedere alla pagina di risultati successiva, 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'