L'endpoint history
fornisce
informazioni storiche sulla qualità dell'aria oraria per una località specifica, per un determinato intervallo di tempo, fino a un massimo di 30 giorni. Puoi controllare gli IQA e le informazioni pertinenti restituiti (ad esempio il livello di concentrazione degli inquinanti e i consigli 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 di richiesta nel corpo della richiesta JSON. Il corpo della richiesta contiene il luogo 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.
Esempio di richiesta di un'ora
Corpo della richiesta di un'ora singola
Il seguente codice mostra come creare il corpo di una richiesta per una richiesta della cronologia di una singola 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 in un'ora
La chiamata precedente genera la seguente risposta JSON. Per ulteriori informazioni 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 creare un corpo della richiesta per una history
che restituisce più record della qualità dell'aria oraria in termini storici.
Puoi richiedere più record specificando un intervallo di tempo, ovvero un timestamp di inizio e di fine, oppure il numero di ore precedenti rispetto all'ora corrente.
Nell'esempio riportato di seguito, poiché hai impostato le dimensioni della pagina su 2
, la tua richiesta di
quattro ore di cronologia della qualità dell'aria viene restituita in due pagine, ognuna 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 riportate sopra generano una risposta JSON nel modulo riportato di seguito. Per ulteriori dettagli sui dati di risposta, consulta 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 relativi alle 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 prossime due
ore di dati.
Per accedere alla pagina successiva dei risultati, effettua una seconda richiesta all'endpoint
history
, ma questa volta imposta la proprietà pageToken
sul
valore 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'