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 sollen, 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 steuern 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
Im folgenden Code wird gezeigt, wie Sie einen Anfragebody für eine einzelne Stunde mit Verlaufsdaten mithilfe der Methode history 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
Der folgende Code zeigt, wie Sie einen Anfragebody für eine history erstellen, die mehrere Datensätze mit stündlichen historischen Luftqualitätsdaten 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 wird Ihre Anfrage nach vier Stunden Luftqualitätsverlauf in zwei Seiten zurückgegeben, da Sie die Seitengröße auf 2 festgelegt haben. Jede Seite enthält zwei Stunden Daten.
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 Request 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. Legen Sie die Eigenschaft pageToken dieses Mal 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'
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.