Der Endpunkt history liefert stündliche Verlaufsdaten 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 Schadstoffkonzentration und Gesundheitsempfehlungen.
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 Ihre Anfrageoptionen in den JSON-Anfragetext ein. Der Anfragetext enthält den Ort 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.
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 einen Anfragetext für eine Anfrage zum Verlauf einer einzelnen Stunde mit der Methode history 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'
Reaktionszeit von 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 einen Zeitraum
Der folgende Code zeigt, wie ein Anfrage-Text 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 ab der aktuellen Zeit angeben.
Im folgenden Beispiel wird die Seitengröße auf 2 festgelegt. Ihre Anfrage für vier Stunden Luftqualitätsverlauf wird daher auf zwei Seiten zurückgegeben, wobei jede Seite zwei Stunden Daten 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 zum Zeitraum
Die obigen Aufrufe generieren eine JSON-Antwort im folgenden Format. Weitere Informationen zu den Antwortdaten finden Sie unter Antwortdaten.
Bei beiden Aufrufen werden Luftqualitätsdaten für vier Stunden angefordert. Da Sie in der Anfrage jedoch das Attribut pageSize auf 2 gesetzt 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 das Attribut nextPageToken enthält. Verwenden Sie dieses Attribut, um auf die nächste Ergebnisseite zuzugreifen, 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 Endpunkt history. Setzen Sie dieses Mal 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'
Testen!
Mit dem APIs Explorer können Sie Beispielanfragen erstellen, 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.
Wählen Sie den Button Ausführen aus. Wählen Sie im Dialogfeld das Konto aus, das Sie für die Anfrage verwenden möchten.
Wählen Sie im APIs Explorer-Bereich das Vollbildsymbol fullscreen aus, um das APIs Explorer-Fenster zu maximieren.