Cronologia

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'