Verlauf

Der Endpunkt history liefert stündliche Informationen zur Luftqualität für einen bestimmten Standort in einem 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. Senden Sie dazu eine HTTP-POST-Anfrage an:

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

Fügen Sie die 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 dem APIs Explorer können Sie Liveanfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen:

Testen!

Beispiel für eine Anfrage für eine Stunde

Text der Anfrage für eine Stunde

Im folgenden Code wird gezeigt, wie Sie mit der Methode history einen Anfragetext für eine Anfrage zum Verlauf einer Stunde erstellen. In diesem Beispiel legen Sie den Ort 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 Anfrage mit Zeitraum

Zeitraumanfrage

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 Datensätze anfordern, indem Sie einen Zeitraum, d. h. einen Start- und Endzeitstempel, oder die Anzahl der Stunden angeben, die ab der aktuellen Zeit zurückliegen.

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 im Zeitraum

Die obigen Aufrufe generieren eine JSON-Antwort im folgenden Format. 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 die Property 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.

Wenn Sie auf die nächste Ergebnisseite zugreifen möchten, senden Sie eine zweite Anfrage an den history-Endpunkt. Legen Sie dabei die Eigenschaft pageToken auf den Wert von nextPageToken aus der ersten Antwort fest.

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'