L'endpoint history
fornisce
informazioni cronologiche sulla qualità dell'aria oraria per una località specifica, per un determinato
di tempo, fino a un massimo di 30 giorni. Puoi controllare quali IQA e
vengono restituite informazioni pertinenti (come il livello di
consigli per la salute).
Puoi richiedere la cronologia della qualità dell'aria oraria utilizzando
history
tramite l'invio di una richiesta POST HTTP a:
https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY
Includi le opzioni di richiesta nel file JSON corpo della richiesta. Corpo della richiesta contiene la posizione e l'intervallo di tempo per cui desideri ottenere cronologia oraria della qualità dell'aria. Potrebbe anche includere varie opzioni per controllare le informazioni sulla qualità dell'aria da includere nella risposta.
L'Explorer API ti consente di effettuare richieste in tempo reale per acquisire familiarità con l'API e le opzioni API:
Esempio di richiesta di un'ora
Corpo della richiesta di un'ora singola
Il codice seguente mostra come creare il corpo di una richiesta per una singola ora
cronologia richiesta utilizzando
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 quanto segue 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 codice seguente mostra come creare il corpo di una richiesta
history
, che restituisce più
record della qualità dell'aria oraria.
Puoi richiedere più record specificando un intervallo di tempo, ovvero un e il timestamp di fine, oppure specificando il numero di ore precedenti al momento nel tempo.
Nell'esempio riportato di seguito, poiché hai impostato le dimensioni della pagina su 2
, la tua richiesta di
vengono restituite quattro ore di cronologia della qualità dell'aria 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 trasmettendo 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 sopra indicate generano Risposta JSON nel modulo di seguito. Per ulteriori dettagli sui dati di risposta, vedi Dati delle risposte.
Entrambe le chiamate precedenti richiedono quattro ore di dati sulla qualità dell'aria. Tuttavia, poiché imposti
la proprietà pageSize
a 2
nella richiesta, la risposta include solo
per le 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
. Usa questa
per accedere alla pagina successiva dei risultati, che contiene le due
ore di dati.
Per accedere alla pagina successiva di risultati, effettua una seconda richiesta alla
Endpoint history
, ma questa volta ha impostato la proprietà pageToken
su
il valore di 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'