Der Endpunkt history stellt stündliche Verlaufsdaten für die Luftqualität eines bestimmten Ortes für einen bestimmten Zeitraum bereit (maximal 30 Tage). Sie können festlegen, welche LQIs 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 Ort und den Zeitraum, für den Sie den Verlauf der stündlichen Luftqualität abrufen möchten. Sie kann auch verschiedene Optionen enthalten, um zu steuern, welche Informationen zur Luftqualität in der Antwort enthalten sein sollen.
Beispiel für eine einstündige Anfrage
1-stündiger Anfragetext
Der folgende Code zeigt, wie Sie mit der Methode history einen Anfragetext für eine einstündige Verlaufsanfrage erstellen.
In diesem Beispiel legen Sie den Ort und den Zeitstempel 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 ein history-Objekt erstellen, das 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 ab dem aktuellen Zeitpunkt angeben.
Da Sie im Beispiel unten die Seitengröße auf 2 gesetzt haben, wird Ihre Anfrage für den Verlauf der Luftqualität von vier Stunden auf zwei Seiten zurückgegeben. Jede Seite enthält dabei Daten aus 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'
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'
Zeitraumantwort
Die oben genannten Aufrufe generieren eine JSON-Antwort im folgenden Format. Weitere Informationen zu den Antwortdaten finden Sie unter Antwortdaten.
In beiden oben genannten Anrufen werden Daten zur Luftqualität von vier Stunden angefordert. Da Sie jedoch das Attribut pageSize in der Anfrage 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 Eigenschaft können Sie die nächste Seite der Ergebnisse aufrufen, 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 aber das Attribut pageToken auf den Wert 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'