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. |
unitsSystem |
Optional. Das Einheitensystem, das für die zurückgegebenen Wetterbedingungen verwendet werden soll. Wenn keine Angabe erfolgt, werden die zurückgegebenen Wetterbedingungen im metrischen System angegeben (Standard = METRIC). |
languageCode |
Optional. Ermöglicht dem Client, die Sprache für die Antwort auszuwählen. Wenn für diese Sprache keine Daten verfügbar sind, wird die nächstgelegene Übereinstimmung verwendet. Zulässige Werte basieren auf dem IETF BCP-47-Standard. Der Standardwert ist „en“. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwort für den RPC „currentConditions.lookup“ – stellt die aktuellen Wetterbedingungen am angeforderten Ort dar.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
|---|
{ "currentTime": string, "timeZone": { object ( |
| Felder | |
|---|---|
currentTime |
Aktuelle Zeit (UTC), die den zurückgegebenen Daten zugeordnet ist. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
timeZone |
Die Zeitzone am angeforderten Ort. |
weatherCondition |
Die aktuelle Wetterlage. |
temperature |
Die aktuelle Temperatur. |
feelsLikeTemperature |
Die gefühlte Temperatur am angeforderten Ort. |
dewPoint |
Die aktuelle Taupunkttemperatur. |
heatIndex |
Die aktuelle Hitzeindex-Temperatur. |
windChill |
Die aktuelle Windchill-Temperatur, also die gefühlte Temperatur auf der Haut. |
precipitation |
Die aktuelle Niederschlagswahrscheinlichkeit und die Niederschlagsmenge, die in der letzten Stunde gefallen ist. |
airPressure |
Die aktuellen Luftdruckbedingungen. |
wind |
Die aktuellen Windverhältnisse. |
visibility |
Die aktuelle Sichtbarkeit. |
currentConditionsHistory |
Die Änderungen der aktuellen Bedingungen in den letzten 24 Stunden. |
isDaytime |
„True“, wenn die aktuelle Zeit am angeforderten Ort zwischen dem lokalen Sonnenaufgang (einschließlich) und dem Sonnenuntergang (ausschließlich) liegt. Andernfalls ist es Nacht (zwischen Sonnenuntergang und dem nächsten Sonnenaufgang). |
relativeHumidity |
Der aktuelle Prozentsatz der relativen Luftfeuchtigkeit (Werte von 0 bis 100). |
uvIndex |
Der aktuelle UV-Index. |
thunderstormProbability |
Die aktuelle Wahrscheinlichkeit für Gewitter (Werte von 0 bis 100). |
cloudCover |
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 der aktuellen Bedingungen in den letzten 24 Stunden dar.
| JSON-Darstellung |
|---|
{ "temperatureChange": { object ( |
| Felder | |
|---|---|
temperatureChange |
Die aktuelle Temperatur minus der Temperatur vor 24 Stunden. |
maxTemperature |
Die Höchsttemperatur in den letzten 24 Stunden. |
minTemperature |
Die Mindesttemperatur in den letzten 24 Stunden. |
snowQpf |
Die Menge an Schnee, gemessen als Flüssigwasseräquivalent, die sich in den letzten 24 Stunden angesammelt hat. Hinweis: QPF ist die Abkürzung für „Quantitative Precipitation Forecast“ (Vorhersage der Niederschlagsmenge). Weitere Informationen finden Sie in der Definition von „QuantitativePrecipitationForecast“. |
qpf |
Die Menge an Niederschlag (Regen), gemessen als Äquivalent in flüssigem Wasser, die sich in den letzten 24 Stunden angesammelt hat. Hinweis: QPF ist die Abkürzung für „Quantitative Precipitation Forecast“ (Vorhersage der Niederschlagsmenge). Weitere Informationen finden Sie in der Definition von „QuantitativePrecipitationForecast“. |