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

string

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 (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), 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 Ort.

weatherCondition

object (WeatherCondition)

Die aktuelle Wetterlage.

temperature

object (Temperature)

Die aktuelle Temperatur.

feelsLikeTemperature

object (Temperature)

Die gefühlte Temperatur am angeforderten Ort.

dewPoint

object (Temperature)

Die aktuelle Taupunkttemperatur.

heatIndex

object (Temperature)

Die aktuelle Hitzeindex-Temperatur.

windChill

object (Temperature)

Die aktuelle Windchill-Temperatur, also die gefühlte Temperatur auf der Haut.

precipitation

object (Precipitation)

Die aktuelle Niederschlagswahrscheinlichkeit und die Niederschlagsmenge, die in der letzten Stunde gefallen ist.

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

„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

integer

Der aktuelle Prozentsatz der relativen Luftfeuchtigkeit (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 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 in den letzten 24 Stunden.

minTemperature

object (Temperature)

Die Mindesttemperatur in den letzten 24 Stunden.

snowQpf

object (QuantitativePrecipitationForecast)

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

object (QuantitativePrecipitationForecast)

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