Gibt die aktuellen Wetterbedingungen an einem bestimmten Ort zurück.
HTTP-Anfrage
GET https://weather.googleapis.com/v1/currentConditions:lookup
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
Parameter | |
---|---|
location |
Erforderlich. Der Standort, für den die aktuellen Wetterbedingungen abgerufen werden sollen. |
units |
Optional. Das Maßsystem, das für die zurückgegebenen Wetterbedingungen verwendet werden soll. Wenn keine Angabe erfolgt, werden die zurückgegebenen Wetterbedingungen im metrischen System angegeben (Standardwert: METRIC). |
language |
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 basieren auf dem IETF-BCP-47-Standard. Der Standardwert ist „de“. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwort für den RPC „currentConditions.lookup“ – stellt die aktuellen Wetterbedingungen am angeforderten Standort dar.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{ "currentTime": string, "timeZone": { object ( |
Felder | |
---|---|
current |
Aktuelle Zeit (UTC) der zurückgegebenen Daten. Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: |
time |
Die Zeitzone des angeforderten Standorts. |
weather |
Das aktuelle Wetter. |
temperature |
Die aktuelle Temperatur. |
feels |
Die gefühlte Temperatur am angegebenen Ort. |
dew |
Die aktuelle Taupunkttemperatur. |
heat |
Der aktuelle Hitzeindex. |
wind |
Die aktuelle Windchill-Temperatur, also die Lufttemperatur, die auf die Haut trifft. |
precipitation |
Die aktuelle Niederschlagswahrscheinlichkeit und die Niederschlagsmenge der letzten Stunde. |
air |
Die aktuellen Luftdruckbedingungen. |
wind |
Die aktuellen Windverhältnisse. |
visibility |
Die aktuelle Sichtbarkeit. |
current |
Die Änderungen der aktuellen Bedingungen in den letzten 24 Stunden. |
is |
„Wahr“, wenn die aktuelle Uhrzeit am angeforderten Ort zwischen Sonnenaufgang (einschließlich) und Sonnenuntergang (ausschließlich) liegt. Andernfalls ist es Nacht (zwischen Sonnenuntergang und nächstem Sonnenaufgang). |
relative |
Die aktuelle relative Luftfeuchtigkeit in Prozent (Werte von 0 bis 100). |
uv |
Der aktuelle UV-Index. |
thunderstorm |
Die aktuelle Wahrscheinlichkeit für Gewitter (Werte von 0 bis 100). |
cloud |
Der aktuelle Prozentsatz des Himmels, der von Wolken bedeckt ist (Werte von 0 bis 100). |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/cloud-platform
CurrentConditionsHistory
Stellt eine Reihe von Änderungen an den aktuellen Bedingungen in den letzten 24 Stunden dar.
JSON-Darstellung |
---|
{ "temperatureChange": { object ( |
Felder | |
---|---|
temperature |
Die aktuelle Temperatur abzüglich der Temperatur vor 24 Stunden. |
max |
Die höchste Temperatur in den letzten 24 Stunden. |
min |
Die niedrigste Temperatur der letzten 24 Stunden. |
qpf |
Die Niederschlagsmenge (Regen oder Schnee), gemessen als flüssiges Wasseräquivalent, die sich in den letzten 24 Stunden angesammelt hat. Hinweis: QPF ist eine Abkürzung für „Quantitative Precipitation Forecast“ (Voraussichtliche Niederschlagsmenge). Weitere Informationen finden Sie in der Definition von „QuantitativePrecipitationForecast“. |