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 Standort, für den die aktuellen Wetterbedingungen abgerufen werden sollen.

unitsSystem

enum (UnitsSystem)

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).

languageCode

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

timeZone

object (TimeZone)

Die Zeitzone des angeforderten Standorts.

weatherCondition

object (WeatherCondition)

Das aktuelle Wetter.

temperature

object (Temperature)

Die aktuelle Temperatur.

feelsLikeTemperature

object (Temperature)

Die gefühlte Temperatur am angegebenen Ort.

dewPoint

object (Temperature)

Die aktuelle Taupunkttemperatur.

heatIndex

object (Temperature)

Der aktuelle Hitzeindex.

windChill

object (Temperature)

Die aktuelle Windchill-Temperatur, also die Lufttemperatur, die auf die Haut trifft.

precipitation

object (Precipitation)

Die aktuelle Niederschlagswahrscheinlichkeit und die Niederschlagsmenge der letzten Stunde.

airPressure

object (AirPressure)

Die aktuellen Luftdruckbedingungen.

wind

object (Wind)

Die aktuellen Windverhältnisse.

visibility

object (Visibility)

Die aktuelle Sichtbarkeit.

currentConditionsHistory

object (CurrentConditionsHistory)

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

isDaytime

boolean

„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).

relativeHumidity

integer

Die aktuelle relative Luftfeuchtigkeit in Prozent (Werte von 0 bis 100).

uvIndex

integer

Der aktuelle UV-Index.

thunderstormProbability

integer

Die aktuelle Wahrscheinlichkeit für Gewitter (Werte von 0 bis 100).

cloudCover

integer

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

object (Temperature)

Die aktuelle Temperatur abzüglich der Temperatur vor 24 Stunden.

maxTemperature

object (Temperature)

Die höchste Temperatur in den letzten 24 Stunden.

minTemperature

object (Temperature)

Die niedrigste Temperatur der letzten 24 Stunden.

qpf

object (QuantitativePrecipitationForecast)

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“.