Verlauf

Der Endpunkt history bietet stündliche Informationen zur Luftqualität für einen bestimmten Ort, für einen bestimmten Zeitraum von bis zu 30 Tagen. Sie können festlegen, welche LQI und werden relevante Informationen zurückgegeben (wie die Schadstoffkonzentration und Gesundheitsempfehlungen).

Sie können den Verlauf der stündlichen Luftqualität über die history Endpunkt durch Senden einer HTTP-POST-Anfrage an folgende Adresse:

https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY

Anfrageoptionen im JSON-Format angeben Anfragetext. Der Anfragetext enthält den Standort und den Zeitraum, für den das Ereignis abgerufen werden soll. stündlichen Verlauf der Luftqualität. Sie kann auch verschiedene Optionen welche Informationen zur Luftqualität in der Antwort enthalten sein sollen.

Mit APIs Explorer können Sie Live-Anfragen stellen, damit Sie sich mit die API und die API-Optionen:

Testen!

Beispiel für eine einstündige Anfrage

Text der Anfrage für eine Stunde

Der folgende Code zeigt, wie ein Anfragetext für eine Stunde erstellt wird. Verlaufsanfrage mit history-Methode. 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 Folgendes: 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 ein Anfragetext für eine history gibt mehrere Aufzeichnungen der bisherigen stündlichen Luftqualität.

Sie können mehrere Einträge anfordern, indem Sie einen Zeitraum angeben. und Endzeitstempel oder durch Angabe der Anzahl von Stunden vom aktuellen .

Da Sie im folgenden Beispiel die Seitengröße auf 2 festgelegt haben, Der Luftqualitätsverlauf von vier Stunden wird auf zwei Seiten zurückgegeben, wobei jede Seite enthält die 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'

Antwort im Zeitraum

Die obigen Aufrufe generieren ein JSON-Antwort im Formular weiter 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 jedoch das Attribut pageSize auf 2 setzen, enthält die Antwort nur 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. Verwenden , um auf die nächste Ergebnisseite zuzugreifen, die die nächsten beiden Stunden an Daten.

Um auf die nächste Ergebnisseite zuzugreifen, senden Sie eine zweite Anfrage an den Endpunkt history. Legen Sie diesmal aber das Attribut pageToken auf 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'