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 vengono restituite informazioni pertinenti (come il livello di consigli per la salute).

Puoi richiedere la cronologia della qualità dell'aria oraria utilizzando history tramite l'invio di una richiesta POST HTTP a:

https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY

Includi le opzioni di richiesta nel file JSON corpo della richiesta. Corpo della richiesta contiene la posizione e l'intervallo di tempo per cui desideri ottenere cronologia oraria della qualità dell'aria. Potrebbe anche includere varie opzioni per controllare le informazioni sulla qualità dell'aria da includere nella risposta.

L'Explorer API ti consente di effettuare richieste in tempo reale per acquisire familiarità con l'API e le opzioni API:

Prova!

Esempio di richiesta di un'ora

Corpo della richiesta di un'ora singola

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 in un'ora

La chiamata riportata sopra 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 codice seguente mostra come creare un corpo della richiesta per un history che restituisce più record della qualità dell'aria storica oraria.

Puoi richiedere più record specificando un intervallo di tempo, ovvero un e il timestamp di fine, oppure specificando il numero di ore precedenti al momento nel tempo.

Nell'esempio riportato di seguito, poiché hai impostato le dimensioni della pagina su 2, la tua richiesta di vengono restituite quattro ore di cronologia della qualità dell'aria 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 trasmettendo 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 sopra indicate generano Risposta JSON nel modulo di seguito. Per ulteriori dettagli sui dati delle risposte, vedi Dati delle risposte.

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

Tieni presente che la risposta include anche la proprietà nextPageToken. Usa questa per accedere alla pagina successiva dei risultati, che contiene le due ore di dati.

Per accedere alla pagina successiva di risultati, effettua una seconda richiesta alla Endpoint history, ma questa volta ha impostato la proprietà pageToken su il valore di 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'