Cronologia

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'