Der Endpunkt history bietet stündliche Informationen zur Luftqualität für einen bestimmten Standort und einen bestimmten Zeitraum von maximal 30 Tagen. Sie können festlegen, welche Luftqualitätsindexe und relevanten Informationen zurückgegeben werden, z. B. die Konzentration von Schadstoffen und Gesundheitsempfehlungen.
Sie können den Verlauf der stündlichen Luftqualität über den Endpunkt history abrufen, 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 Luftqualitätsverlauf 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:
Beispiel für eine Anfrage für eine einzelne Stunde
Anfragetext für eine einzelne Stunde
Der folgende Code zeigt, wie Sie mit der Methode history einen Anfragebody für eine einzelne Stunde erstellen.
In diesem Beispiel legen Sie den Standort und den vergangenen Zeitstempel 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 für einen Zeitraum
Anfrage für Zeitraum
Im folgenden Code wird gezeigt, wie Sie einen Anfragebody für eine history erstellen, die mehrere Datensätze mit stündlichen historischen Daten zur Luftqualität zurückgibt.
Sie können mehrere Datensätze anfordern, indem Sie einen Zeitraum mit einem Start- und Endzeitstempel oder die Anzahl der Stunden vor der aktuellen Zeit angeben.
Im Beispiel unten haben Sie die Seitengröße auf 2 festgelegt. Ihre Anfrage für vier Stunden Luftqualitätsverlauf wird daher auf zwei Seiten zurückgegeben, wobei jede Seite Daten für 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 einen ähnlichen Antrag 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'
Reaktion auf den Zeitraum
Die oben genannten Aufrufe generieren eine JSON-Antwort in der folgenden Form. Weitere Informationen zu den Antwortdaten finden Sie unter Antwortdaten.
Bei beiden Aufrufen oben werden Daten zur Luftqualität für vier Stunden angefordert. Da Sie das Attribut pageSize im Antrag auf 2 gesetzt haben, enthält die Antwort jedoch 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 Eigenschaft 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, stellen Sie eine zweite Anfrage an den Endpunkt history. Setzen Sie die Eigenschaft pageToken dieses Mal 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'
Testen!
Mit dem APIs Explorer können Sie Beispielanfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen.
Wählen Sie rechts auf der Seite das API-Symbol api aus.
Bearbeiten Sie optional die Anfrageparameter.
Klicken Sie auf die Schaltfläche Ausführen. Wählen Sie im Dialogfeld das Konto aus, das Sie für die Anfrage verwenden möchten.
Wählen Sie im Bereich „APIs Explorer“ das Symbol für den Vollbildmodus fullscreen aus, um das APIs Explorer-Fenster zu maximieren.