- HTTP-Anfrage
- Suchparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- CurrentConditionsHistory
- Testen!
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 Ort, für den die aktuellen Wetterbedingungen abgerufen werden sollen. |
unitsSystem |
Optional. Das Einheitensystem, das für die zurückgegebenen Wetterbedingungen verwendet werden soll. Wenn nicht angegeben, 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 bereitgestellt werden können, verwendet die API die nächstgelegene Übereinstimmung. 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 Standort dar.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
|---|
{ "currentTime": string, "timeZone": { object ( |
| Felder | |
|---|---|
currentTime |
Aktuelle Uhrzeit (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 Standort. |
weatherCondition |
Die aktuelle Wetterlage. |
temperature |
Die aktuelle Temperatur. |
feelsLikeTemperature |
Die gefühlte Temperatur am angefragten Ort. |
dewPoint |
Die aktuelle Taupunkttemperatur. |
heatIndex |
Die aktuelle Hitzeindex-Temperatur. Hinweis: Für Standorte in Japan und Südkorea wird |
windChill |
Der aktuelle Windchill, also die Lufttemperatur, die auf der Haut wahrgenommen wird. Hinweis: Für Orte in Japan und Südkorea wird |
precipitation |
Die aktuelle Niederschlagswahrscheinlichkeit und die Niederschlagsmenge der letzten Stunde. |
airPressure |
Der aktuelle Luftdruck. |
wind |
Die aktuellen Windverhältnisse. |
visibility |
Die aktuelle Sichtbarkeit. Hinweis: Dieses Feld gibt für Standorte in Japan und Südkorea ein leeres Objekt zurück. |
currentConditionsHistory |
Die Änderungen der aktuellen Bedingungen in den letzten 24 Stunden. |
isDaytime |
„Wahr“, wenn die aktuelle Uhrzeit am angeforderten Standort 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 Gewitterwahrscheinlichkeit (Werte von 0 bis 100). Hinweis: Dieses Feld wird in der Antwort für Orte in Japan und Südkorea weggelassen. |
cloudCover |
Der aktuelle Prozentsatz des Himmels, der von Wolken bedeckt ist (Werte von 0 bis 100). Hinweis: Dieses Feld wird in der Antwort für Orte in Japan und Südkorea weggelassen. |
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 der letzten 24 Stunden. |
minTemperature |
Die Mindesttemperatur (niedrig) in den letzten 24 Stunden. |
snowQpf |
Die Schneemenge, die voraussichtlich über einen bestimmten Zeitraum fällt, unter der Annahme, dass kein Schnee schmilzt oder verdichtet wird. Hinweis: Dies ist die tatsächliche Schneemenge, nicht das Flüssigwasseräquivalent. QPF ist die Abkürzung für Quantitative Precipitation Forecast (weitere Informationen finden Sie in der Definition von QuantitativePrecipitationForecast). |
qpf |
Das gesamte flüssige Wasseräquivalent aller Niederschläge (Regen, Schnee, Eis usw.), die voraussichtlich über einen bestimmten Zeitraum fallen werden. Hinweis: QPF ist die Abkürzung für Quantitative Precipitation Forecast (Quantitative Niederschlagsvorhersage). Weitere Informationen finden Sie in der Definition von QuantitativePrecipitationForecast. |