Method: currentConditions.lookup

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

object (LatLng)

Erforderlich. Der Ort, für den die aktuellen Wetterbedingungen abgerufen werden sollen.

unitsSystem

enum (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

string

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 (TimeZone)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "currentConditionsHistory": {
    object (CurrentConditionsHistory)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Felder
currentTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

timeZone

object (TimeZone)

Die Zeitzone am angeforderten Standort.

weatherCondition

object (WeatherCondition)

Die aktuelle Wetterlage.

temperature

object (Temperature)

Die aktuelle Temperatur.

feelsLikeTemperature

object (Temperature)

Die gefühlte Temperatur am angefragten Ort.

dewPoint

object (Temperature)

Die aktuelle Taupunkttemperatur.

heatIndex

object (Temperature)

Die aktuelle Hitzeindex-Temperatur.

Hinweis: Für Standorte in Japan und Südkorea wird heatIndex für hohe Temperaturen zurückgegeben und ansonsten weggelassen.

windChill

object (Temperature)

Der aktuelle Windchill, also die Lufttemperatur, die auf der Haut wahrgenommen wird.

Hinweis: Für Orte in Japan und Südkorea wird windChill für sehr niedrige Temperaturen zurückgegeben und ansonsten weggelassen.

precipitation

object (Precipitation)

Die aktuelle Niederschlagswahrscheinlichkeit und die Niederschlagsmenge der letzten Stunde.

airPressure

object (AirPressure)

Der aktuelle Luftdruck.

wind

object (Wind)

Die aktuellen Windverhältnisse.

visibility

object (Visibility)

Die aktuelle Sichtbarkeit.

Hinweis: Dieses Feld gibt für Standorte in Japan und Südkorea ein leeres Objekt zurück.

currentConditionsHistory

object (CurrentConditionsHistory)

Die Änderungen der aktuellen Bedingungen in den letzten 24 Stunden.

isDaytime

boolean

„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

integer

Der aktuelle Prozentsatz der relativen Luftfeuchtigkeit (Werte von 0 bis 100).

uvIndex

integer

Der aktuelle UV-Index.

thunderstormProbability

integer

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

integer

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 (Temperature)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Felder
temperatureChange

object (Temperature)

Die aktuelle Temperatur minus der Temperatur vor 24 Stunden.

maxTemperature

object (Temperature)

Die Höchsttemperatur der letzten 24 Stunden.

minTemperature

object (Temperature)

Die Mindesttemperatur (niedrig) in den letzten 24 Stunden.

snowQpf

object (QuantitativePrecipitationForecast)

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

object (QuantitativePrecipitationForecast)

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.