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 steuern, welche LQI und relevanten Informationen zurückgegeben werden (z. B. die Schadstoffkonzentration und Gesundheitsempfehlungen).
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 Ihre Anfrageoptionen in den JSON-Anfragetext ein. Der Anfragetext enthält den Standort und den Zeitraum, für den Sie den stündlichen Luftqualitätsverlauf abrufen möchten. Sie kann auch verschiedene Optionen enthalten, mit denen Sie festlegen können, welche Informationen zur Luftqualität in der Antwort enthalten sein sollen.
Beispiel für eine einstündige Anfrage
Text der Anfrage 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 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 Zeitraumanfrage
Zeitraumanfrage
Der folgende Code zeigt, wie Sie einen Anfragetext für eine history erstellen, die mehrere Datensätze der bisherigen stündlichen Luftqualität 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.
Da Sie im folgenden Beispiel die Seitengröße auf 2 festlegen, wird Ihre Anfrage für einen vierstündigen Luftqualitätsverlauf auf zwei Seiten zurückgegeben, wobei jede Seite Daten aus zwei Stunden enthält.
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 oben genannten Aufrufe generieren eine JSON-Antwort im Formular unten. Weitere Informationen zu den Antwortdaten finden Sie unter Antwortdaten.
Für beide Aufrufe oben werden Daten zur Luftqualität von vier Stunden angefordert. Da Sie das Attribut pageSize in der Anfrage jedoch auf 2 gesetzt haben, enthält die Antwort nur die Ergebnisse der 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 Seite der Ergebnisse 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'