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 quali IQA e le informazioni pertinenti vengono restituiti (ad esempio il livello di concentrazione di 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 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.

Esempio di richiesta di una sola ora

Corpo della richiesta singola ora

Il codice seguente mostra come costruire un corpo di una richiesta per una singola richiesta di cronologia oraria 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 riportata 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 codice seguente mostra come creare un corpo della richiesta per una 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 di fine, oppure specificando il numero di ore dall'ora corrente.

Nell'esempio riportato di seguito, poiché hai impostato le dimensioni della pagina su 2, la tua 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 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 formato di seguito. Per ulteriori dettagli sui dati delle risposte, consulta Dati delle risposte.

Entrambe le chiamate precedenti richiedono dati sulla qualità dell'aria di quattro ore. Tuttavia, poiché imposti la proprietà pageSize su 2 nella richiesta, la risposta include solo i risultati relativi alle 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 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 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'