Method: forecast.hours.lookup

Liefert bis zu 240 Stunden stündliche Vorhersagen für einen bestimmten Ort ab der aktuellen Stunde zurück.

HTTP-Anfrage

GET https://weather.googleapis.com/v1/forecast/hours:lookup

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
location

object (LatLng)

Erforderlich. Der Ort, für den die stündliche Vorhersage abgerufen werden soll.
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).
pageSize

integer

Optional. Die maximale Anzahl von Einträgen für die stündliche Vorhersage, die pro Seite zurückgegeben werden sollen. Der Wert muss zwischen 1 und 24 liegen. Der Standardwert ist der maximal zulässige Wert von 24.
pageToken

string

Optional. Ein Seitentoken, das von einer vorherigen Anfrage empfangen wurde. Es wird verwendet, um die nächste Seite abzurufen.
hours

integer

Optional. Hiermit wird die Anzahl der Stunden begrenzt, die ab der aktuellen Stunde abgerufen werden sollen. Der Wert muss zwischen 1 und 240 liegen. Der Standardwert ist der maximal zulässige Wert von 240.
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 hours.lookup-RPC

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "forecastHours": [
    {
      object (ForecastHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Felder
forecastHours[]

object (ForecastHour)

Die Datensätze der stündlichen Vorhersage entsprechend der in der Anfrage angegebenen Anzahl von Stunden und Seitengröße.
timeZone

object (TimeZone)

Die Zeitzone des angeforderten Standorts.
nextPageToken

string

Das Token zum Abrufen der nächsten Seite.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

ForecastHour

Stellt einen Eintrag für die stündliche Vorhersage an einem bestimmten Standort dar.

JSON-Darstellung 
{
  "interval": {
    object (Interval)
  },
  "displayDateTime": {
    object (DateTime)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "wetBulbTemperature": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Felder
interval

object (Interval)

Das Intervall von einer Stunde (in UTC-Zeit), für das diese Prognosedaten gültig sind. Die Zeitstempel werden auf die nächste volle Stunde abgerundet.
displayDateTime

object (DateTime)

Das lokale Datum und die lokale Uhrzeit in der Zeitzone des Orts (bürgerliche Zeit), für den diese stündliche Vorhersage berechnet wird. Dieses Feld kann für die Anzeige auf dem Client verwendet werden. Hinweis: Dieses Datum besteht aus Jahr, Monat, Tag, Stunde und Zeitzonen-Offset.
weatherCondition

object (WeatherCondition)

Die prognostizierten Wetterbedingungen.
temperature

object (Temperature)

Die prognostizierte Temperatur.
feelsLikeTemperature

object (Temperature)

Gibt an, wie sich die Temperatur am angegebenen Ort anfühlt.
dewPoint

object (Temperature)

Die prognostizierte Taupunkttemperatur.
heatIndex

object (Temperature)

Die prognostizierte Temperatur des Hitzeindexes.
windChill

object (Temperature)

Die prognostizierte Windchill-Temperatur, die Lufttemperatur, die auf die Haut trifft.
wetBulbTemperature

object (Temperature)

Die prognostizierte Kühlgrenztemperatur, die niedrigste Temperatur, die durch Verdunsten von Wasser erreicht werden kann.
precipitation

object (Precipitation)

Die prognostizierte Niederschlagswahrscheinlichkeit und die Niederschlagsmenge der letzten Stunde.
airPressure

object (AirPressure)

Die prognostizierten Luftdruckbedingungen.
wind

object (Wind)

Die prognostizierten Windbedingungen.
visibility

object (Visibility)

Die prognostizierte Sichtbarkeit.
iceThickness

object (IceThickness)

Die prognostizierte Eisdicke.
isDaytime

boolean

„Wahr“, wenn diese Stunde zwischen Sonnenaufgang (einschließlich) und Sonnenuntergang (ausschließlich) liegt. Andernfalls ist es Nacht (zwischen Sonnenuntergang und nächstem Sonnenaufgang). Hinweis: Diese Stunde wird als Tag oder Nacht betrachtet, wenn das Intervall mit den Zeiten des Sonnenaufgangs bzw.Sonnenuntergangs übereinstimmt. Beispiel: Wenn das Intervall von 5:00 bis 6:00 Uhr dauert und der Sonnenaufgang um 5:59 Uhr ist, ist „isDaytime“ wahr.
relativeHumidity

integer

Der prognostizierte relative Luftfeuchtigkeitsprozentsatz (Werte von 0 bis 100).
uvIndex

integer

Der prognostizierte UV-Index.
thunderstormProbability

integer

Die prognostizierte Gewitterwahrscheinlichkeit (Werte von 0 bis 100).
cloudCover

integer

Der prognostizierte Prozentsatz des Himmels, der von Wolken bedeckt ist (Werte von 0 bis 100).