Cronologia

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:

Prova!

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'