Package google.maps.airquality.v1

Index

AirQuality

Dienste zur Luftqualität

LookupCurrentConditions

rpc LookupCurrentConditions(LookupCurrentConditionsRequest) returns (LookupCurrentConditionsResponse)

Der Endpunkt „Aktuelle Bedingungen“ bietet stündliche Informationen zur Luftqualität in mehr als 100 Ländern mit einer Auflösung von bis zu 500 × 500 Metern. Enthält über 70 lokale Indizes sowie globale Luftqualitätsindizes und ‑kategorien.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

rpc LookupForecast(LookupForecastRequest) returns (LookupForecastResponse)

Gibt die Luftqualitätsvorhersage 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 OAuth 2.0-Übersicht.
LookupHeatmapTile

rpc LookupHeatmapTile(LookupHeatmapTileRequest) returns (HttpBody)

Gibt ein Byte-Array mit den Daten des PNG-Bilds der Kachel zurück.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

rpc LookupHistory(LookupHistoryRequest) returns (LookupHistoryResponse)

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der OAuth 2.0-Übersicht.

AirQualityIndex

Das Basisobjekt für die Darstellung verschiedener Luftqualitätsmesswerte. Zusammengenommen geben diese Messwerte einen Überblick über die aktuelle Luftqualität. Es gibt mehrere Indexe auf der Welt, die verschiedenen Zwecken dienen und Gruppen dienen, die verschiedene Aspekte der Luftqualität messen möchten.

Felder
code

string

Der Code des Index. Dieses Feld stellt den Index für Programmierzwecke dar. Dabei wird die Snake-Case-Schreibweise anstelle von Leerzeichen verwendet. Beispiele: „uaqi“, „fra_atmo“.
display_name

string

Eine für Menschen lesbare Darstellung des Indexnamens. Beispiel: „LQI (US)“
aqi_display

string

Textuelle Darstellung der numerischen Indexbewertung, die Präfix- oder Suffixsymbole enthalten kann und in der Regel die schlechteste Indexbewertung darstellt. Beispiel: > 100 oder 10+.

Hinweis: Dieses Feld sollte verwendet werden, wenn Sie den Indexwert anzeigen möchten. Bei nicht numerischen Indexen ist dieses Feld leer.
color

Color

Die Farbe, mit der der numerische LQI-Wert dargestellt wird.
category

string

Textuelle Klassifizierung der numerischen Bewertung des Index. Beispiel: „Hervorragende Luftqualität“
dominant_pollutant

string

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

int32

Die numerische Bewertung des Index. Beispiele: 10, 100.

Der Wert ist nicht normalisiert und sollte nur im Zusammenhang mit dem zugehörigen Luftqualitätsindex interpretiert werden. Bei nicht numerischen Indexen wird dieses Feld nicht zurückgegeben.

Hinweis: Dieses Feld sollte für Berechnungen, die Darstellung in Diagrammen usw. verwendet werden. Verwenden Sie das Anzeigefeld für den LQI, um den Indexwert anzuzeigen.

ColorPalette

Bestimmt die Farbpalette, die für die vom „Universal Air Quality Index“ (UAQI) bereitgestellten Daten verwendet wird. Diese Farbpalette ist nur für den LQI relevant. Andere LQIs haben eine vordefinierte Farbpalette, die nicht geändert werden kann.

Enums
COLOR_PALETTE_UNSPECIFIED Der Standardwert. Wird ignoriert, wenn er als Parameter übergeben wird.
RED_GREEN Bestimmt, ob eine Rot/Grün-Farbpalette verwendet werden soll.
INDIGO_PERSIAN_DARK Bestimmt, ob eine Indigo-/Persische Palette (dunkles Design) verwendet werden soll.
INDIGO_PERSIAN_LIGHT Bestimmt, ob eine Indigo-/Persische Palette (helles Design) verwendet werden soll.

CustomLocalAqi

Gibt die Beziehung zwischen Land/Region und LQI an. Hiermit wird ein Land/eine Region mit einem gewünschten LQI verknüpft, damit die für dieses Land/diese Region erforderlichen Luftqualitätsdaten gemäß dem ausgewählten LQI angezeigt werden.

Felder
region_code

string

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

string

Der LQI, der dem Land bzw. der Region zugeordnet 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 entsprechenden Elemente und Felder in der Antwort zurückgegeben.

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

Bestimmt, ob der lokale (nationale) LQI des angeforderten Orts (Landes) in die Antwort eingeschlossen werden soll.

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

Bestimmt, ob die Antwort die Gesundheitsempfehlungen und empfohlenen Maßnahmen für die aktuellen LQI-Bedingungen enthält.

Die Empfehlungen sind auf die Allgemeinbevölkerung und sechs Risikogruppen zugeschnitten, die empfindlicher auf Schadstoffe reagieren als die Allgemeinbevölkerung.

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

Gibt an, ob die zusätzlichen Informationen zu den einzelnen Schadstoffen in der Antwort enthalten sein sollen.

Falls angegeben, enthält jedes Luftqualitätsindexobjekt im Feld „indexes“ der Antwort ein Feld additional_info, wenn die Daten verfügbar sind.
DOMINANT_POLLUTANT_CONCENTRATION

Bestimmt, ob die Antwort die Konzentrationen der vorherrschenden Schadstoffe enthält, die gemäß globalen und/oder lokalen Indizes gemessen wurden.

Wenn in der Anfrage sowohl der globale LQI als auch der lokale LQI angegeben ist, werden möglicherweise bis zu zwei Schadstoffcodes zurückgegeben.

Falls angegeben, enthält das Objekt mit dem vorherrschenden Schadstoff in der Liste „pollutants“ ein Feld concentration, wenn die Daten verfügbar sind.
POLLUTANT_CONCENTRATION

Bestimmt, ob die Antwort die Konzentrationen aller Schadstoffe mit verfügbaren Messungen gemäß globalen und/oder lokalen Indizes enthält.

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

HealthRecommendations

Gesundheitsempfehlungen für verschiedene Bevölkerungsgruppen im Freitextformat. Die Empfehlungen basieren auf den zugehörigen Luftqualitätsbedingungen.

Felder
general_population

string

Keine besonderen Empfindlichkeiten.
elderly

string

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

string

Atemwegsprobleme und Asthma
heart_disease_population

string

Herz- und Kreislauferkrankungen
athletes

string

Sport und andere anstrengende Outdooraktivitäten
pregnant_women

string

Frauen in allen Schwangerschaftsphasen
children

string

Jüngere Zielgruppen, einschließlich Kindern, Kleinkindern und Babys.

LookupCurrentConditionsRequest

Die Anfragedefinition der aktuellen Luftqualität.

Felder
location

LatLng

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

ExtraComputation

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

ColorPalette

Optional. Bestimmt die Farbpalette, die für Daten verwendet wird, die vom Universal Air Quality Index (UAQI) bereitgestellt werden. Diese Farbpalette ist nur für den LQI relevant. Andere LQIs haben eine vordefinierte Farbpalette, die nicht geändert werden kann.
custom_local_aqis[]

CustomLocalAqi

Optional. Gibt die Beziehung zwischen Land/Region und LQI an. Hiermit wird ein Land/eine Region mit einem gewünschten LQI verknüpft, damit die für dieses Land/diese Region erforderlichen Luftqualitätsdaten gemäß dem ausgewählten LQI angezeigt werden. Mit diesem Parameter kann ein nicht standardmäßiger LQI für ein bestimmtes Land angegeben werden, z. B. um den Index der US-amerikanischen Umweltschutzbehörde (EPA) für Kanada anstelle des Standardindexes für Kanada abzurufen.
universal_aqi

bool

Optional. Wenn diese Option auf „true“ festgelegt ist, wird der universelle LQI in das Feld „indexes“ der Antwort aufgenommen. Der Standardwert ist "true".
language_code

string

Optional. Ermöglicht es 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 nächstgelegene Übereinstimmung. Zulässige Werte richten sich nach dem IETF-Standard. Der Standardwert ist „en“.

LookupCurrentConditionsResponse

Felder
date_time

Timestamp

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

string

Der ISO_3166-1-Alpha-2-Code des Landes/der Region, das/die dem in der Anfrage angegebenen Standort entspricht. Dieses Feld wird möglicherweise aus der Antwort entfernt, wenn sich der in der Anfrage angegebene Standort in einem umstrittenen Gebiet befindet.
indexes[]

AirQualityIndex

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

  • LQI (Global). Wird zurückgegeben, wenn der boolesche Wert „universalAqi“ auf „true“ gesetzt ist.
  • Lokaler LQI Wird zurückgegeben, wenn die zusätzliche Berechnung LOCAL_AQI angegeben ist.
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, bei denen mindestens eine der folgenden zusätzlichen Berechnungen angegeben wurde: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
health_recommendations

HealthRecommendations

Gesundheitsempfehlungen und empfohlene Maßnahmen im Zusammenhang mit den gemeldeten Luftqualitätsbedingungen. Die Empfehlungen sind für gefährdete Bevölkerungsgruppen, Gruppen mit einer höheren Empfindlichkeit gegenüber Schadstoffen und die Allgemeinbevölkerung unterschiedlich ausgestaltet.

LookupForecastRequest

Das Anfrageobjekt der API für die Luftqualitätsvorhersage.

Felder
location

LatLng

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

ExtraComputation

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

ColorPalette

Optional. Bestimmt die Farbpalette, die für Daten verwendet wird, die vom Universal Air Quality Index (UAQI) bereitgestellt werden. Diese Farbpalette ist nur für den LQI relevant. Andere LQIs haben eine vordefinierte Farbpalette, die nicht geändert werden kann.
custom_local_aqis[]

CustomLocalAqi

Optional. Gibt die Beziehung zwischen Land/Region und LQI an. Hiermit wird ein Land/eine Region mit einem gewünschten LQI verknüpft, damit die für dieses Land/diese Region erforderlichen Luftqualitätsdaten gemäß dem ausgewählten LQI angezeigt werden. Mit diesem Parameter kann ein nicht standardmäßiger LQI für ein bestimmtes Land angegeben werden, z. B. um den Index der US-amerikanischen Umweltschutzbehörde (EPA) für Kanada anstelle des Standardindexes für Kanada abzurufen.
page_size

int32

Optional. Die maximale Anzahl der stündlichen Infoeinträge, die pro Seite zurückgegeben werden sollen (Standard = 24).
page_token

string

Optional. Ein Seitentoken, das von einem vorherigen Forecast-Aufruf empfangen wurde. Es wird verwendet, um die nächste Seite abzurufen.
Union-Feld time_range. Der Zeitraum der erforderlichen Daten zur Luftqualitätsvorhersage. Der Zeitraum muss mindestens eine gerundete Stunde in der Zukunft liegen. Wenn Sie dieses Feld nicht angeben, wird der Fehler INVALID_ARGUMENT zurückgegeben. 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 vorherige volle Stunde gerundet.

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

Interval

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

bool

Optional. Wenn diese Option auf „wahr“ festgelegt ist, wird der universelle LQI im Feld „indexes“ der Antwort enthalten sein (Standardeinstellung: „wahr“).
language_code

string

Optional. Ermöglicht es 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 nächstgelegene Übereinstimmung. Zulässige Werte richten sich nach dem IETF-Standard (Standardwert: „en“).

LookupForecastResponse

Das Antwortobjekt der API für die Luftqualitätsvorhersage.

Felder
hourly_forecasts[]

HourlyForecast

Optional. Enthält die Informationen zur Luftqualität für jede Stunde im angeforderten Zeitraum. Wenn Sie beispielsweise eine Prognose für 48 Stunden anfordern, gibt es 48 Elemente mit stündlichen Prognosen.
region_code

string

Optional. Der ISO_3166-1-Alpha-2-Code des Landes/der Region, das/die dem in der Anfrage angegebenen Standort entspricht. Dieses Feld wird möglicherweise aus der Antwort entfernt, 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 Informationen zur Luftqualität für jede Stunde im angeforderten Zeitraum. Wenn Sie beispielsweise eine Prognose für 48 Stunden anfordern, gibt es 48 Elemente mit stündlichen Prognosen.

Felder
date_time

Timestamp

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

AirQualityIndex

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

  • LQI (Global). Wird zurückgegeben, wenn der boolesche Wert universal_aqi auf „wahr“ festgelegt ist.
  • Lokaler LQI Wird zurückgegeben, wenn die zusätzliche Berechnung für den LQI angegeben ist.
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, bei denen mindestens eine der folgenden zusätzlichen Berechnungen angegeben wurde: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
health_recommendations

HealthRecommendations

Gesundheitsempfehlungen und empfohlene Maßnahmen im Zusammenhang mit den gemeldeten Luftqualitätsbedingungen. Die Empfehlungen sind für gefährdete Bevölkerungsgruppen, Gruppen mit einer höheren Empfindlichkeit gegenüber Schadstoffen und die Allgemeinbevölkerung unterschiedlich ausgestaltet.

LookupHeatmapTileRequest

Eine Heatmap-Kachelanfrage.

Die Struktur entspricht dem standardmäßigen GET-Aufruf des Kachelstors, also 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 Heatmap für die Luftqualität. Hier wird der Schadstoff definiert, der auf der Karte grafisch dargestellt wird.

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. Hiermit wird festgelegt, wie groß oder klein die Inhalte einer Karte in einer Kartenansicht angezeigt werden.

Bei Zoomstufe 0 wird die ganze Welt in einer einzigen Kachel dargestellt. Bei Zoomstufe 1 ist die gesamte Welt in 4 Kacheln zu sehen. Bei Zoomstufe 2 wird die gesamte Welt in 16 Kacheln dargestellt. Bei Zoomstufe 16 wird die gesamte Welt in 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 API für den Luftqualitätsverlauf.

Felder
page_size

int32

Optional. Die maximale Anzahl der stündlichen Infoeinträge, die pro Seite zurückgegeben werden sollen. Der Standardwert ist 72 und der Maximalwert 168 (Daten der letzten 7 Tage).
page_token

string

Optional. Ein Seitentoken, das von einem vorherigen Verlaufsaufruf empfangen wurde. Es wird verwendet, um die nächste 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 die die API nach Verlaufsdaten zur Luftqualität sucht.
extra_computations[]

ExtraComputation

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

ColorPalette

Optional. Bestimmt die Farbpalette, die für Daten verwendet wird, die vom Universal Air Quality Index (UAQI) bereitgestellt werden. Diese Farbpalette ist nur für den LQI relevant. Andere LQIs haben eine vordefinierte Farbpalette, die nicht geändert werden kann.
custom_local_aqis[]

CustomLocalAqi

Optional. Gibt die Beziehung zwischen Land/Region und LQI an. Hiermit wird ein Land/eine Region mit einem gewünschten LQI verknüpft, damit die für dieses Land/diese Region erforderlichen Luftqualitätsdaten gemäß dem ausgewählten LQI angezeigt werden. Mit diesem Parameter kann ein nicht standardmäßiger LQI für ein bestimmtes Land angegeben werden, z. B. um den Index der US-amerikanischen Umweltschutzbehörde (EPA) für Kanada anstelle des Standardindexes für Kanada abzurufen.
Union-Feld time_range. Der Zeitraum der erforderlichen Daten zur Luftqualität. Wenn Sie kein Feld für den Zeitraum angeben, wird der Fehler INVALID_ARGUMENT zurückgegeben. „time_range“ kann nur einen der folgenden Werte haben: time_range kann nur einen der folgenden Werte haben:
date_time

Timestamp

Ein Zeitstempel, für den Verlaufsdaten zurückgegeben werden sollen. Der Zeitstempel wird auf die vorherige volle Stunde gerundet.

Hinweis: Dabei werden nur stündliche Daten für den angeforderten Zeitstempel zurückgegeben (d.h. ein einzelnes stündliches Infoelement). Beispiel: Eine Anfrage, bei der der 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

Eine Zahl zwischen 1 und 720, die den Stundenzeitraum für die Anfrage angibt. Beispiel: Bei einem Wert von 48 werden Daten aus den letzten 48 Stunden angezeigt.
period

Interval

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

bool

Optional. Wenn diese Option auf „true“ festgelegt ist, wird der universelle LQI im Feld „indexes“ der Antwort enthalten sein. Der Standardwert ist "true".
language_code

string

Optional. Ermöglicht es 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 nächstgelegene Übereinstimmung. Zulässige Werte richten sich nach dem IETF-Standard. Der Standardwert ist „en“.

LookupHistoryResponse

Felder
hours_info[]

HourInfo

Optional. Enthält die Informationen zur Luftqualität für jede Stunde im angeforderten Zeitraum. Wenn Sie beispielsweise den Verlauf der letzten 48 Stunden anfordern, erhalten Sie 48 Stundendaten.
region_code

string

Optional. Der ISO_3166-1-Alpha-2-Code des Landes/der Region, das/die dem in der Anfrage angegebenen Standort entspricht. Dieses Feld wird möglicherweise aus der Antwort entfernt, 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 Informationen zur Luftqualität für jede Stunde im angeforderten Zeitraum. Wenn Sie beispielsweise den Verlauf der letzten 48 Stunden anfordern, erhalten Sie 48 Stundendaten.

Felder
date_time

Timestamp

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

AirQualityIndex

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

  • LQI (Global). Wird zurückgegeben, wenn der boolesche Wert „universalAqi“ auf „true“ gesetzt ist.
  • Lokaler LQI Wird zurückgegeben, wenn die zusätzliche Berechnung LOCAL_AQI angegeben ist.
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, bei denen mindestens eine der folgenden zusätzlichen Berechnungen angegeben wurde: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
health_recommendations

HealthRecommendations

Gesundheitsempfehlungen und empfohlene Maßnahmen im Zusammenhang mit den gemeldeten Luftqualitätsbedingungen. Die Empfehlungen sind für gefährdete Bevölkerungsgruppen, Gruppen mit einer höheren Empfindlichkeit gegenüber Schadstoffen und die Allgemeinbevölkerung unterschiedlich ausgestaltet.

Kartentyp

Der Typ der Heatmap für die Luftqualität. Hier wird der Schadstoff definiert, der auf der Karte grafisch dargestellt wird.

Enums
MAP_TYPE_UNSPECIFIED Der Standardwert. Der Server ignoriert ihn, wenn er als Parameter übergeben wird.
UAQI_RED_GREEN Rot-grüne Farbpalette des universellen Luftqualitätsindex
UAQI_INDIGO_PERSIAN Universal Air Quality Index indigo-persische Palette.
PM25_INDIGO_PERSIAN PM2.5-Index – Indigo-persische Palette
GBR_DEFRA Farbpalette für den täglichen Luftqualitätsindex (Vereinigtes Königreich)
DEU_UBA Farbpalette für den deutschen LQI
CAN_EC Farbpalette des kanadischen Luftqualitätsindex
FRA_ATMO Farbvorlage für den Luftqualitätsindex in Frankreich
US_AQI Farbpalette des US-amerikanischen Luftqualitätsindex

Schadstoff

Daten zu einem Schadstoff in der Luftqualität.

Felder
code

string

Der Codename des Schadstoffs (z. B. „so2“). Eine Liste der unterstützten Schadstoffcodes finden Sie unter Gemeldete Schadstoffe.
display_name

string

Der Anzeigename des Schadstoffs. Beispiel: „NOx“.
full_name

string

Der vollständige Name des Schadstoffs. Bei chemischen Verbindungen ist dies der IUPAC-Name. Beispiel: „Schwefeldioxid“

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

Concentration

Die Konzentration des Schadstoffs, gemessen in einer der Standardeinheiten für die Luftverschmutzung.
additional_info

AdditionalInfo

Weitere Informationen zum Schadstoff.

AdditionalInfo

Die Emissionsquellen und Gesundheitsauswirkungen eines bestimmten Schadstoffs.

Felder
sources

string

Text, der die Hauptemisssionsquellen des Schadstoffs darstellt.
effects

string

Text, der die wichtigsten gesundheitsschädlichen Auswirkungen des Schadstoffs darstellt.

Konzentration

Die Konzentration eines bestimmten Schadstoffs in der Luft.

Felder
units

Unit

Maßeinheiten für die Messung dieser Schadstoffkonzentration.
value

float

Wert der Schadstoffkonzentration.

Einheit

Definiert die Maßeinheit, mit der die Konzentration des Schadstoffs gemessen wird. Die Standardeinheit der Konzentration für einen bestimmten Schadstoff finden Sie in der Tabelle unter Angezeigte Schadstoffe.

Enums
UNIT_UNSPECIFIED Nicht angegebene Konzentrationseinheit.
PARTS_PER_BILLION Die Konzentrationseinheit „ppb“ (parts per billion).
MICROGRAMS_PER_CUBIC_METER Die Konzentrationseinheit „µg/m³“ (Mikrogramm pro Kubikmeter).