Verlauf

Der Endpunkt history enthält stündliche Verlaufsdaten zur Luftqualität für einen bestimmten Standort und einen bestimmten Zeitraum von maximal 30 Tagen. Sie können festlegen, welche LQIs und relevanten Informationen zurückgegeben werden sollen, z. B. die Konzentration von Schadstoffen und Empfehlungen für die Gesundheit.

Sie können den Verlauf der stündlichen Luftqualität über den Endpunkt history anfordern, indem Sie eine HTTP-POST-Anfrage an folgende Adresse senden:

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

Fügen Sie Ihre Anfrageoptionen in den JSON-Anfragetext ein. Der Anfragetext enthält den Standort und den Zeitraum, für den Sie den stündlichen Verlauf der Luftqualität abrufen möchten. Außerdem kann es verschiedene Optionen enthalten, mit denen Sie festlegen können, welche Informationen zur Luftqualität in die Antwort aufgenommen werden sollen.

Mit APIs Explorer können Sie Live-Anfragen stellen, damit Sie sich mit der API und den API-Optionen vertraut machen können:

Testen!

Beispiel für eine Anfrage für eine Stunde

Anfragetext für eine Stunde

Der folgende Code zeigt, wie Sie mit der Methode history einen Anfragetext für eine einstündige Anfrage mit dem Verlauf erstellen. In diesem Beispiel legen Sie den Standort und den Zeitstempel in der Vergangenheit fest.

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'

Antwort innerhalb einer Stunde

Der obige Aufruf generiert die folgende JSON-Antwort. Weitere Informationen zu den Antwortdaten finden Sie unter Antwortdaten.

{
    "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"
}

Beispiel für eine Zeitraumanfrage

Anfrage für Zeitraum

Im folgenden Code wird gezeigt, wie ein Anfragetext für eine history erstellt wird, die mehrere Datensätze mit historischen stündlichen Luftqualitätsdaten zurückgibt.

Sie können mehrere Einträge anfordern, indem Sie einen Zeitraum angeben, also einen Start- und Endzeitstempel, oder die Anzahl der Stunden in der Vergangenheit ab der aktuellen Uhrzeit.

Im folgenden Beispiel wird Ihre Anfrage für die Luftqualitätsdaten der letzten vier Stunden auf zwei Seiten zurückgegeben, da Sie die Seitengröße auf 2 festgelegt haben. Jede Seite enthält Daten für zwei Stunden.

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'

Sie können eine ähnliche Anfrage stellen, indem Sie die Start- und Endzeitstempel übergeben:

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'

Antwort für den Zeitraum

Die obigen Aufrufe generieren eine JSON-Antwort im Formular unten. Weitere Informationen zu den Antwortdaten finden Sie unter Antwortdaten.

Bei beiden Aufrufen werden Daten zur Luftqualität für vier Stunden angefordert. Da Sie jedoch in der Anfrage das Attribut pageSize auf 2 festgelegt haben, enthält die Antwort nur Ergebnisse für die letzten zwei Stunden.

{
    "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"
}

Beachten Sie, dass die Antwort auch das Attribut nextPageToken enthält. Mit dieser Property können Sie auf die nächste Ergebnisseite zugreifen, die die Daten der nächsten zwei Stunden enthält.

Um auf die nächste Ergebnisseite zuzugreifen, senden Sie eine zweite Anfrage an den Endpunkt history. Setzen Sie diesmal jedoch das Attribut pageToken auf den Wert von nextPageToken aus der ersten Antwort.

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'