Method: currentConditions.lookup

Der Endpunkt für aktuelle Bedingungen bietet stündliche Informationen zur Luftqualität in mehr als 100 Ländern mit einer Auflösung von bis zu 500 x 500 Metern. Umfasst über 70 lokale Indizes sowie globalen Luftqualitätsindex und -kategorien.

HTTP-Anfrage

POST https://airquality.googleapis.com/v1/currentConditions:lookup

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "location": {
    object (LatLng)
  },
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "uaqiColorPalette": enum (ColorPalette),
  "customLocalAqis": [
    {
      object (CustomLocalAqi)
    }
  ],
  "universalAqi": boolean,
  "languageCode": string
}
Felder
location

object (LatLng)

Erforderlich. Der Längen- und Breitengrad, von dem aus die API nach Daten zur Luftqualität und aktuellen Wetterbedingungen sucht.
extraComputations[]

enum (ExtraComputation)

Optional. Zusätzliche Funktionen, die optional aktiviert werden können. Wenn zusätzliche Berechnungen angegeben werden, werden die relevanten Elemente und Felder in der Antwort zurückgegeben.
uaqiColorPalette

enum (ColorPalette)

Optional. Hier legen Sie die Farbpalette für die Daten fest, die gemäß dem universellen Luftqualitätsindex (Universal Air Quality Index, UQI) bereitgestellt werden. Diese Farbvorlage ist nur für UAQI relevant. Andere AQIs haben eine vorgegebene Farbpalette, die nicht gesteuert werden kann.
customLocalAqis[]

object (CustomLocalAqi)

Optional. Gibt eine Beziehung zwischen Land/Region und AQI an. Koppelt ein Land/eine Region mit einem gewünschten Luftqualitätsindex, sodass für dieses Land/diese Region erforderliche Luftqualitätsdaten gemäß dem ausgewählten Luftqualitätsindex angezeigt werden. Mit diesem Parameter kann ein nicht standardmäßiger AQI für ein bestimmtes Land angegeben werden. So können Sie beispielsweise den US EPA-Index für Kanada statt des Standardindex für Kanada abrufen.
universalAqi

boolean

Optional. Wenn dieser Parameter auf „true“ gesetzt ist, wird der universelle AQI in das Feld „indexes“ der Antwort eingefügt. Der Standardwert ist "true".
languageCode

string

Optional. Ermöglicht dem Client, die Sprache für die Antwort auszuwählen. Wenn für diese Sprache keine Daten zur Verfügung gestellt werden können, verwendet die API die genaueste Übereinstimmung. Zulässige Werte basieren auf dem IETF-Standard. Der Standardwert ist „en“.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung 
{
  "dateTime": string,
  "regionCode": string,
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  }
}
Felder
dateTime

string (Timestamp format)

Ein abgerundeter Zeitstempel im Format RFC3339 UTC „Zulu“ mit einer Auflösung von Nanosekunden und bis zu neun Nachkommastellen. Beispiel: „2014-10-02T15:00:00Z“.
regionCode

string

Der ISO_3166-1 Alpha-2-Code des Landes/der Region, die dem in der Anfrage angegebenen Standort entspricht. Dieses Feld kann in der Antwort weggelassen werden, wenn sich der in der Anfrage angegebene Standort in einem umstrittenen Gebiet befindet.
indexes[]

object (AirQualityIndex)

Je nach Anfrageparametern enthält diese Liste bis zu zwei Luftqualitätsindexe:

  • Universeller Luftqualitätsindex (LQI). Wird zurückgegeben, wenn der boolesche Wert "universalAqi" auf "true" gesetzt ist.
  • LQI (lokal) Wird zurückgegeben, wenn die zusätzliche LOCAL_AQI-Berechnung angegeben ist.
pollutants[]

object (Pollutant)

Eine Liste der Schadstoffe, die sich auf den in der Anfrage angegebenen Standort auswirken. Hinweis: Dieses Feld wird nur für Anfragen zurückgegeben, für die mindestens eine der folgenden zusätzlichen Berechnungen angegeben wurde: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
healthRecommendations

object (HealthRecommendations)

Gesundheitstipps und empfohlene Maßnahmen in Bezug auf die gemeldete Luftqualität. Empfehlungen werden unterschiedlich auf Bevölkerungsgruppen, Gruppen mit höherer Sensibilität für Schadstoffe und die allgemeine Bevölkerung zugeschnitten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.