Package google.maps.airquality.v1

Index

AirQuality

Luftqualitätsdienste

LookupCurrentConditions

rpc LookupCurrentConditions(LookupCurrentConditionsRequest) returns (LookupCurrentConditionsResponse)

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

rpc LookupForecast(LookupForecastRequest) returns (LookupForecastResponse)

Gibt die Luftqualitätsprognose für einen bestimmten Ort für einen bestimmten Zeitraum zurück.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

rpc LookupHeatmapTile(LookupHeatmapTileRequest) returns (HttpBody)

Gibt ein Byte-Array zurück, das die Daten des Kachel-PNG-Bilds enthält.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

rpc LookupHistory(LookupHistoryRequest) returns (LookupHistoryResponse)

Gibt den Verlauf der Luftqualität für einen bestimmten Ort für einen bestimmten Zeitraum zurück.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

AirQualityIndex

Das Basisobjekt zur Darstellung verschiedener Messwerte zur Luftqualität. Zusammen bieten diese Messwerte eine Momentaufnahme der aktuellen Luftqualität. Weltweit gibt es mehrere Indexe für unterschiedliche Zwecke und Gruppen, die verschiedene Aspekte der Luftqualität messen möchten.

Felder
code

string

Code des Index. Dieses Feld stellt den Index zu Programmierzwecken dar, indem Snake Case anstelle von Leerzeichen verwendet wird. Beispiele: „uaqi“, „fra_atmo“.
display_name

string

Eine menschenlesbare Darstellung des Indexnamens. Beispiel: „AQI (US)“
aqi_display

string

Textuale Darstellung des numerischen Indexwerts, einschließlich Präfix- oder Suffixsymbole, die normalerweise die schlechteste Indexbewertung darstellen. Beispiel: >100 oder 10+.

Hinweis: Verwenden Sie dieses Feld, wenn Sie die Indexpunktzahl anzeigen möchten. Bei nicht numerischen Indexen ist dieses Feld leer.
color

Color

Die Farbe zur Darstellung des numerischen AQI-Werts.
category

string

Textklassifizierung der Interpretation des numerischen Indexwerts. Beispiel: „Hervorragende Luftqualität“.
dominant_pollutant

string

Das chemische Symbol des dominanten Schadstoffs. Beispiel: „CO“.
aqi

int32

Der numerische Wert des Index. Beispiele: 10, 100.

Der Wert ist nicht normalisiert und sollte nur im Kontext des zugehörigen Luftqualitätsindexes interpretiert werden. Bei nicht numerischen Indexen wird dieses Feld nicht zurückgegeben.

Hinweis: Dieses Feld sollte für Berechnungen, die Anzeige von Grafiken usw. verwendet werden. Zur Anzeige der Indexbewertung sollten Sie das Feld „LQI-Anzeige“ verwenden.

ColorPalette

Legt die Farbpalette für die vom Universal Air Quality Index (UAQI) bereitgestellten Daten fest. Diese Farbvorlage ist nur für UQI relevant. Andere AQIs haben eine vordefinierte Farbpalette, die nicht gesteuert werden kann.

Enums
COLOR_PALETTE_UNSPECIFIED Der Standardwert. Wird ignoriert, wenn als Parameter übergeben wird.
RED_GREEN Legt fest, ob eine Rot-Grün-Palette verwendet wird.
INDIGO_PERSIAN_DARK Legt fest, ob eine indigo-/persische Palette (dunkles Design) verwendet wird.
INDIGO_PERSIAN_LIGHT Legt fest, ob eine indigo-/persische Palette (helles Design) verwendet wird.

CustomLocalAqi

Drückt eine Beziehung zwischen Land/Region und AQI aus. 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.

Felder
region_code

string

Das Land bzw. die Region, für die der benutzerdefinierte LQI erforderlich ist. Der Wert muss mit dem Code ISO 3166-1 alpha-2 angegeben werden.
aqi

string

Der LQI, mit dem das Land bzw. die Region verknüpft werden soll. Der Wert muss ein gültiger Indexcode sein.

ExtraComputation

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

Enums
EXTRA_COMPUTATION_UNSPECIFIED Der Standardwert. Er wird vom Server ignoriert, wenn er als Parameter übergeben wird.
LOCAL_AQI

Legt fest, ob der lokale (nationale) Luftqualitätsindex (LQI) des angeforderten Standorts (Land) in die Antwort aufgenommen wird.

Wenn angegeben, enthält die Antwort die Datenstruktur „air_quality_index“ mit allen relevanten Daten zum lokalen LQI des Standorts.
HEALTH_RECOMMENDATIONS

Damit wird festgelegt, ob die Antworten die Gesundheitsberatung und empfohlene Maßnahmen für die aktuellen LQI-Erkrankungen enthalten.

Die Empfehlungen sind auf die Allgemeinbevölkerung und auf sechs Bevölkerungsgruppen zugeschnitten, deren Risikogruppen eine höhere Schadstoffempfindlichkeit haben als die Allgemeinbevölkerung.

Wenn angegeben, wird das Feld health_recommendations in der Antwort ausgefüllt, sobald die relevanten Daten verfügbar sind.
POLLUTANT_ADDITIONAL_INFO

Legt fest, ob die zusätzlichen Informationen zu jedem Schadstoff in die Reaktion aufgenommen werden.

Wenn angegeben, enthält jedes Luftqualitätsindexobjekt, das in der Antwort des Felds „Indexe“ enthalten ist, ein additional_info-Feld, wenn Daten verfügbar sind.
DOMINANT_POLLUTANT_CONCENTRATION

Bestimmt, ob die Reaktion die Konzentrationen der dominanten Schadstoffe umfassen würde, die nach globalen und/oder lokalen Indexen gemessen wurden.

Wenn in der Anforderung sowohl der globale LQI als auch der lokale Luftqualitätsindex angegeben wurden, können bis zu zwei Schadstoffcodes zurückgegeben werden.

Wenn angegeben, enthält das dominante Schadstoffobjekt in der Liste „Schadstoffe“ das Feld concentration, sofern Daten verfügbar sind.
POLLUTANT_CONCENTRATION

Bestimmt, ob die Reaktion die Konzentration aller Schadstoffe umfassen würde, für die Messwerte gemäß globalen und/oder lokalen Indexen verfügbar sind.

Wenn angegeben, enthält jedes Schadstoffobjekt, das in der Antwort im Feld „pollutants“ enthalten ist, ein concentration-Feld, wenn Daten verfügbar sind.

HealthRecommendations

Gesundheitsempfehlungen für verschiedene Bevölkerungsgruppen im Freitextformat. Die Empfehlungen basieren auf den jeweiligen Bedingungen für die Luftqualität.

Felder
general_population

string

Keine spezifischen Empfindlichkeiten.
elderly

string

Rentner und Personen, die älter sind als die Allgemeinbevölkerung.
lung_disease_population

string

Atemprobleme und Asthma leiden.
heart_disease_population

string

Erkrankungen des Herz- und Kreislaufsystems.
athletes

string

Sport und andere anstrengende Aktivitäten im Freien.
pregnant_women

string

Frauen in allen Phasen der Schwangerschaft.
children

string

Jüngere Bevölkerungsgruppen, einschließlich Kindern, Kleinkindern und Babys.

LookupCurrentConditionsRequest

Die Definition der aktuellen Luftqualitätsbedingungen für das Ersuchen.

Felder
location

LatLng

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

ExtraComputation

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

ColorPalette

Optional. Legt die Farbpalette für die vom Universal Air Quality Index (UAQI) bereitgestellten Daten fest. Diese Farbvorlage ist nur für UQI relevant. Andere AQIs haben eine vordefinierte Farbpalette, die nicht gesteuert werden kann.
custom_local_aqis[]

CustomLocalAqi

Optional. Drückt eine Beziehung zwischen Land/Region und AQI aus. 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, um beispielsweise den US-EPA-Index für Kanada und nicht den Standardindex für Kanada zu erhalten.
universal_aqi

bool

Optional. Wenn die Richtlinie auf „true“ gesetzt ist, wird der universelle LQI in das Feld „indexes“ der Antwort aufgenommen. Der Standardwert ist "true".
language_code

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 beste Übereinstimmung. Zulässige Werte basieren auf dem IETF-Standard. Der Standardwert ist „en“.

LookupCurrentConditionsResponse

Felder
date_time

Timestamp

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

string

Der Alpha-2-Code gemäß ISO_3166-1 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[]

AirQualityIndex

Abhängig von den Anfrageparametern enthält diese Liste (bis zu) zwei Luftqualitätsindexe:

  • Universeller Luftqualitätsindex (LQI). Wird zurückgegeben, wenn der boolesche Wert „universalAqi“ auf „true“ festgelegt ist.
  • LQI vor Ort Wird zurückgegeben, wenn die zusätzliche LOCAL_AQI-Berechnung angegeben wird.
pollutants[]

Pollutant

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

HealthRecommendations

Gesundheitstipps und empfohlene Maßnahmen in Bezug auf die gemeldete Luftqualität. Die Empfehlungen werden unterschiedlich auf gefährdete Bevölkerungsgruppen, Gruppen mit höherer Schadstoffempfindlichkeit und Allgemeinbevölkerung zugeschnitten.

LookupForecastRequest

Das Anfrageobjekt der Luftqualitätsprognose-API.

Felder
location

LatLng

Erforderlich. Breiten- und Längengrad, für den die API nach Luftqualitätsdaten sucht.
extra_computations[]

ExtraComputation

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

ColorPalette

Optional. Legt die Farbpalette für die vom Universal Air Quality Index (UAQI) bereitgestellten Daten fest. Diese Farbvorlage ist nur für UQI relevant. Andere AQIs haben eine vordefinierte Farbpalette, die nicht gesteuert werden kann.
custom_local_aqis[]

CustomLocalAqi

Optional. Drückt eine Beziehung zwischen Land/Region und AQI aus. 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, um beispielsweise den US-EPA-Index für Kanada und nicht den Standardindex für Kanada zu erhalten.
page_size

int32

Optional. Maximale Anzahl von stündlichen Informationseinträgen, die pro Seite zurückgegeben werden sollen (Standard: 24).
page_token

string

Optional. Ein Seitentoken, das von einem vorherigen Prognoseaufruf empfangen wurde. Sie wird verwendet, um die nachfolgende Seite abzurufen.
Union-Feld time_range. Der Zeitraum für die erforderlichen Prognosedaten zur Luftqualität. Der Bereich muss mindestens eine gerundete Stunde in der Zukunft liegen. Wenn dieses Feld nicht angegeben wird, führt dies zum Fehler INVALID_ ARGUMENT. Für time_range ist nur einer der folgenden Werte zulässig:
date_time

Timestamp

Ein Zeitstempel, für den die Daten für einen bestimmten Zeitpunkt zurückgegeben werden sollen. Der Zeitstempel wird auf die genaue vorherige Stunde aufgerundet.

Hinweis: Dadurch werden nur für den angeforderten Zeitstempel stündliche Daten zurückgegeben (d.h. ein einzelnes stündliches Infoelement). Beispielsweise wird eine Anfrage, die gesendet wurde, bei der der Parameter „date_time“ auf 2023-01-03T11:05:49Z gesetzt ist, auf 2023-01-03T11:00:00Z abgerundet.
period

Interval

Gibt den Start- und Endzeitraum an, für den Prognosedaten abgerufen werden sollen. Der Zeitstempel wird auf die genaue vorherige Stunde aufgerundet.
universal_aqi

bool

Optional. Wenn die Richtlinie auf „true“ gesetzt ist, wird der universelle LQI in das Feld „indexes“ der Antwort aufgenommen (Standardeinstellung: „true“).
language_code

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 beste Übereinstimmung. Zulässige Werte basieren auf dem IETF-Standard (Standard = 'en').

LookupForecastResponse

Das Antwortobjekt der Luftqualitätsprognose-API.

Felder
hourly_forecasts[]

HourlyForecast

Optional. Enthält die Daten zur Luftqualität für jede Stunde im angeforderten Bereich. Wenn beispielsweise eine Prognose für 48 Stunden angefordert wird, gibt es 48 Elemente für stündliche Prognosen.
region_code

string

Optional. Der Alpha-2-Code gemäß ISO_3166-1 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.
next_page_token

string

Optional. Das Token zum Abrufen der nächsten Seite.

HourlyForecast

Enthält die Daten zur Luftqualität für jede Stunde im angeforderten Bereich. Wenn beispielsweise eine Prognose für 48 Stunden angefordert wird, gibt es 48 Elemente für stündliche Prognosen.

Felder
date_time

Timestamp

Ein abgerundeter Zeitstempel, der die Zeit (Stunde) angibt, auf die sich die Daten im Format RFC3339 UTC „Zulu“ beziehen. Beispiel: „2014-10-02T15:00:00Z“.
indexes[]

AirQualityIndex

Abhängig von den Anfrageparametern enthält diese Liste (bis zu) zwei Luftqualitätsindexe:

  • Universeller Luftqualitätsindex (LQI). Wird zurückgegeben, wenn der boolesche Wert universal_aqi auf „true“ festgelegt ist.
  • LQI vor Ort Wird zurückgegeben, wenn die zusätzliche LOCAL_AQI-Berechnung angegeben wird.
pollutants[]

Pollutant

Eine Liste der Schadstoffe, die sich auf den in der Anfrage angegebenen Ort auswirken.

Hinweis: Dieses Feld wird nur für Anfragen zurückgegeben, in denen mindestens eine der folgenden zusätzlichen Berechnungen angegeben wurde: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
health_recommendations

HealthRecommendations

Gesundheitstipps und empfohlene Maßnahmen in Bezug auf die gemeldete Luftqualität. Die Empfehlungen werden unterschiedlich auf gefährdete Bevölkerungsgruppen, Gruppen mit höherer Schadstoffempfindlichkeit und Allgemeinbevölkerung zugeschnitten.

LookupHeatmapTileRequest

Eine Heatmap-Kachelanfrage.

Die Struktur entspricht dem GET-Standardaufruf für Kachelserver: https://airquality.googleapis.com/v1/mapTypes/{map_type}/heatmapTiles/{zoom}/{x}/{y}

Beispiel: https://airquality.googleapis.com/v1/mapTypes/BAQI_INDIGO_PERSIAN/heatmapTiles/1/1/1

Felder
map_type

MapType

Erforderlich. Der Typ der Luftqualitäts-Heatmap. Definiert den Schadstoff, den die Karte grafisch darstellen soll.

Allowed values:
- UAQI_RED_GREEN (UAQI, red-green palette)
- UAQI_INDIGO_PERSIAN (UAQI, indigo-persian palette)
- PM25_INDIGO_PERSIAN
- GBR_DEFRA
- DEU_UBA
- CAN_EC
- FRA_ATMO
- US_AQI
zoom

int32

Erforderlich. Die Zoomstufe der Karte. Legt fest, wie groß oder klein der Inhalt einer Karte in einer Kartenansicht angezeigt wird.

Zoomstufe 0 bezieht sich auf die ganze Welt in einer einzelnen Kachel. Zoomstufe 1 stellt die gesamte Welt in vier Kacheln dar. In Zoomstufe 2 ist die ganze Welt in 16 Kacheln dargestellt. In Zoomstufe 16 wird die ganze Welt mit 65.536 Kacheln dargestellt.

Zulässige Werte: 0–16
x

int32

Erforderlich. Definiert den Ost-West-Punkt in der angeforderten Kachel.
y

int32

Erforderlich. Definiert den Nord-Süd-Punkt in der angeforderten Kachel.

LookupHistoryRequest

Das Anfrageobjekt der Air Quality History API.

Felder
page_size

int32

Optional. Die maximale Anzahl stündlicher Datensätze, die pro Seite zurückgegeben werden sollen. Der Standardwert ist 72 und der Maximalwert 168 (Daten aus 7 Tagen).
page_token

string

Optional. Ein von einem vorherigen Verlaufsaufruf empfangenes Seitentoken. Sie wird verwendet, um die nachfolgende Seite abzurufen.

Wenn Sie einen Wert für diesen Parameter angeben, müssen alle anderen angegebenen Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat (der vorherige Aufruf).
location

LatLng

Erforderlich. Breiten- und Längengrad, für den die API nach Luftqualitätsverlaufsdaten sucht.
extra_computations[]

ExtraComputation

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

ColorPalette

Optional. Legt die Farbpalette für die vom Universal Air Quality Index (UAQI) bereitgestellten Daten fest. Diese Farbvorlage ist nur für UQI relevant. Andere AQIs haben eine vordefinierte Farbpalette, die nicht gesteuert werden kann.
custom_local_aqis[]

CustomLocalAqi

Optional. Drückt eine Beziehung zwischen Land/Region und AQI aus. 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, um beispielsweise den US-EPA-Index für Kanada und nicht den Standardindex für Kanada zu erhalten.
Union-Feld time_range. Der Zeitraum für die erforderlichen Daten zur Luftqualität. Wenn kein zeitraumbezogenes Feld angegeben ist, wird der Fehler INVALID_ ARGUMENT zurückgegeben. „time_range“ kann nur einer der folgenden Werte sein: time_range kann nur einer der folgenden Werte sein:
date_time

Timestamp

Ein Zeitstempel, für den historische Daten zurückgegeben werden sollen. Der Zeitstempel wird auf die genaue vorherige Stunde aufgerundet.

Hinweis: Dadurch werden nur für den angeforderten Zeitstempel stündliche Daten zurückgegeben (d.h. ein einzelnes stündliches Infoelement). Beispiel: Eine Anfrage, die gesendet wurde und für den Parameter „dateTime“ auf „2023-01-03T11:05:49Z“ festgelegt ist, wird auf 2023-01-03T11:00:00Z abgerundet.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: „2014-10-02T15:01:23Z“ und „2014-10-02T15:01:23.045123456Z“.
hours

int32

Zahl von 1 bis 720, die den Stundenbereich für die Anfrage angibt. Beispiel: Ein Wert von 48 liefert Daten aus den letzten 48 Stunden.
period

Interval

Gibt den Start- und Endzeitraum an, für den Verlaufsdaten abgerufen werden sollen. Der Zeitstempel wird auf die genaue vorherige Stunde aufgerundet.
universal_aqi

bool

Optional. Wenn die Richtlinie auf „true“ gesetzt ist, wird der universelle LQI in das Feld „indexes“ der Antwort aufgenommen. Der Standardwert ist "true".
language_code

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 beste Übereinstimmung. Zulässige Werte basieren auf dem IETF-Standard. Der Standardwert ist „en“.

LookupHistoryResponse

Felder
hours_info[]

HourInfo

Optional. Enthält die Daten zur Luftqualität für jede Stunde im angeforderten Bereich. Wenn sich die Anfrage beispielsweise auf einen Verlauf von 48 Stunden bezieht, sind 48 Stündliche Informationen aus 48 Elementen vorhanden.
region_code

string

Optional. Der Alpha-2-Code gemäß ISO_3166-1 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.
next_page_token

string

Optional. Das Token zum Abrufen der nächsten Seite.

HourInfo

Enthält die Daten zur Luftqualität für jede Stunde im angeforderten Bereich. Wenn sich die Anfrage beispielsweise auf einen Verlauf von 48 Stunden bezieht, sind 48 Stündliche Informationen aus 48 Elementen vorhanden.

Felder
date_time

Timestamp

Ein abgerundeter Zeitstempel, der die Zeit angibt, auf die sich die Daten im Format RFC3339 UTC „Zulu““ beziehen, mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiel: „2014-10-02T15:00:00Z“.
indexes[]

AirQualityIndex

Abhängig von den Anfrageparametern enthält diese Liste (bis zu) zwei Luftqualitätsindexe:

  • Universeller Luftqualitätsindex (LQI). Wird zurückgegeben, wenn der boolesche Wert „universalAqi“ auf „true“ festgelegt ist.
  • LQI vor Ort Wird zurückgegeben, wenn die zusätzliche LOCAL_AQI-Berechnung angegeben wird.
pollutants[]

Pollutant

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

HealthRecommendations

Gesundheitstipps und empfohlene Maßnahmen in Bezug auf die gemeldete Luftqualität. Die Empfehlungen werden unterschiedlich auf gefährdete Bevölkerungsgruppen, Gruppen mit höherer Schadstoffempfindlichkeit und Allgemeinbevölkerung zugeschnitten.

MapType

Der Typ der Luftqualitäts-Heatmap. Definiert den Schadstoff, den die Karte grafisch darstellen soll.

Enums
MAP_TYPE_UNSPECIFIED Der Standardwert. Er wird vom Server ignoriert, wenn er als Parameter übergeben wird.
UAQI_RED_GREEN Rot-Grün-Palette für Universal-Luftqualitätsindex.
UAQI_INDIGO_PERSIAN Farbpalette für Universal Air Quality Index (Indigopersisch).
PM25_INDIGO_PERSIAN PM2,5-Index indigo-persisch.
GBR_DEFRA Farbpalette für den täglichen Luftqualitätsindex (UK)
DEU_UBA Farbpalette für den deutschen Luftqualitätsindex.
CAN_EC Farbpalette für den kanadischen Luftqualitätsindex.
FRA_ATMO Farbpalette für den Luftqualitätsindex Frankreich
US_AQI Farbpalette für den Luftqualitätsindex (USA)

Schadstoff

Daten zu einem Luftqualitätsschadstoff.

Felder
code

string

Der Codename des Schadstoffs. Beispiel: „so2“. Eine Liste aller verfügbaren Codes finden Sie hier.
display_name

string

Anzeigename des Schadstoffs Beispiel: „NOx“.
full_name

string

Der vollständige Name des Schadstoffs. Für chemische Verbindungen ist dies die IUPAC-Bezeichnung. Beispiel: „Schwefeldioxid“.

Weitere Informationen zur IUPAC-Namenstabelle findest du unter https://iupac.org/what-we-do/periodic-table-of-elements/.
concentration

Concentration

Die Konzentration des Schadstoffs, gemessen mit einer der standardmäßigen Maßeinheiten für die Luftverschmutzung.
additional_info

AdditionalInfo

Zusätzliche Informationen zum Schadstoff.

AdditionalInfo

Emissionsquellen und gesundheitliche Auswirkungen eines bestimmten Schadstoffs

Felder
sources

string

Text, der die wichtigsten Emissionsquellen des Schadstoffs darstellt.
effects

string

Text, der die wichtigsten gesundheitlichen Auswirkungen des Schadstoffs darstellt.

Konzentration

Die Konzentration eines bestimmten Schadstoffs in der Luft.

Felder
units

Unit

Einheiten für die Messung dieser Schadstoffkonzentration.
value

float

Wert der Schadstoffkonzentration.

Einheit

Definiert die Einheit, in der die Konzentration des Schadstoffs gemessen wird.

Enums
UNIT_UNSPECIFIED Nicht angegebene Konzentrationseinheit.
PARTS_PER_BILLION Die Konzentrationseinheit in ppb (Parts per Milliarde).
MICROGRAMS_PER_CUBIC_METER Die Konzentrationseinheit in „μg/m^3“ (Mikrogramm pro Kubikmeter).