L'endpoint history fornisce
informazioni storiche orarie sulla qualità dell'aria 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 restituite (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'
history
endpoint inviando una richiesta HTTP POST a:
https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY
Includi le opzioni della richiesta nel corpo della richiesta JSON request body. Il corpo della richiesta contiene la località e l'intervallo di tempo per cui vuoi ottenere la cronologia oraria della qualità dell'aria. Può anche includere varie opzioni per controllare quali informazioni sulla qualità dell'aria includere nella risposta.
L'Explorer API ti consente di effettuare richieste live per familiarizzare con l'API e le opzioni dell'API:
Esempio di richiesta per una singola ora
Corpo della richiesta per una singola ora
Il seguente codice mostra come creare un corpo della richiesta per una richiesta di cronologia di una singola ora
utilizzando il
history metodo.
In questo esempio, imposti la località 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 per una singola ora
La chiamata precedente genera la seguente risposta JSON. Per ulteriori 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 di qualità dell'aria oraria storica.
Puoi richiedere più record specificando un intervallo di tempo, ovvero un timestamp di inizio e di fine, o specificando il numero di ore a partire dall'ora corrente.
Nell'esempio riportato di seguito, poiché hai impostato le dimensioni della pagina su 2, la 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 dell'intervallo di tempo
Le chiamate precedenti generano una risposta JSON nel formato riportato di seguito. Per ulteriori dettagli sui dati della risposta, consulta Dati della risposta.
Entrambe le chiamate precedenti richiedono dati sulla qualità dell'aria per quattro ore. Tuttavia, poiché hai impostato la proprietà pageSize su 2 nella richiesta, la risposta include solo i risultati per le 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 successive 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 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'
Fai una prova!
L'Explorer API ti consente di effettuare richieste di esempio per familiarizzare con l'API e le opzioni dell'API.
Seleziona l'icona dell'API api sul lato destro della pagina.
Se vuoi, modifica i parametri della 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 a schermo intero fullscreen per espandere la finestra Explorer API.