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

Anfragetext 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 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 Anfrage mit Zeitraum

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 zurück, die seit der aktuellen Uhrzeit vergangen sind.

Im folgenden Beispiel wird Ihre Anfrage für vier Stunden Verlaufsdaten zur Luftqualität 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'

Du kannst eine ähnliche Anfrage stellen, indem du den Start- und Endzeitstempel übergibst:

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 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'