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 ( |
Felder | |
---|---|
location |
Erforderlich. Der Längen- und Breitengrad, von dem aus die API nach Daten zur Luftqualität und aktuellen Wetterbedingungen sucht. |
extraComputations[] |
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 |
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[] |
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 |
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 |
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 ( |
Felder | |
---|---|
dateTime |
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 |
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[] |
Je nach Anfrageparametern enthält diese Liste bis zu zwei Luftqualitätsindexe:
|
pollutants[] |
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 |
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.