Method: forecast.hours.lookup

Gibt bis zu 240 Stunden stündlicher Vorhersagen für einen bestimmten Ort zurück, beginnend mit der aktuellen Stunde.

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

integer

Optional. Die maximale Anzahl der stündlichen Vorhersagedatensätze, die pro Seite zurückgegeben werden sollen. Der Wert muss zwischen 1 und 24 (einschließlich) liegen. Der Standardwert ist der maximal zulässige Wert von 24.
pageToken

string

Optional. Ein Seitentoken, das von einer vorherigen Anfrage empfangen wurde. Sie wird zum Abrufen der nachfolgenden Seite verwendet.
hours

integer

Optional. Begrenzt die Anzahl der abzurufenden Stunden ab der aktuellen Stunde – ein Wert zwischen 1 und 240 (einschließlich). Der Standardwert ist der maximal zulässige Wert von 240.
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 „hours.lookup“.

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 stündlichen Prognosedatensätze entsprechend der Anzahl der Stunden und der Seitengröße, die in der Anfrage angegeben sind.
timeZone

object (TimeZone)

Die Zeitzone am angeforderten Ort.
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 stündlichen Vorhersagedatensatz an einem bestimmten Ort 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 einstündige Intervall (in UTC-Zeit), für das diese Prognosedaten gültig sind. Die Zeitstempel werden auf die nächste Stunde abgerundet.
displayDateTime

object (DateTime)

Das lokale Datum und die Uhrzeit in der Zeitzone des Ortes (bürgerliche Zeit), für die 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 UTC-Versatz.
weatherCondition

object (WeatherCondition)

Die vorhergesagte Wetterlage.
temperature

object (Temperature)

Die vorhergesagte Temperatur.
feelsLikeTemperature

object (Temperature)

Das Maß dafür, wie sich die Temperatur am angeforderten Ort anfühlt.
dewPoint

object (Temperature)

Die vorhergesagte Taupunkttemperatur.
heatIndex

object (Temperature)

Die vorhergesagte Hitzeindex-Temperatur.
windChill

object (Temperature)

Die vorhergesagte Windchill-Temperatur, die auf der Haut zu spüren ist.
wetBulbTemperature

object (Temperature)

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

object (Precipitation)

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

object (AirPressure)

Die vorhergesagten Luftdruckbedingungen.
wind

object (Wind)

Die vorhergesagten Windbedingungen.
visibility

object (Visibility)

Die prognostizierte Sichtbarkeit.
iceThickness

object (IceThickness)

Die prognostizierte Eisdicke.
isDaytime

boolean

„True“, wenn diese Stunde zwischen dem lokalen Sonnenaufgang (einschließlich) und Sonnenuntergang (ausschließlich) liegt. Andernfalls ist es Nacht (zwischen Sonnenuntergang und dem nächsten Sonnenaufgang). Hinweis: Diese Stunde wird als Tag oder Nacht betrachtet, wenn sich das Intervall mit den lokalen Sonnenauf- bzw.Sonnenuntergangszeiten überschneidet. Beispiel: Wenn das Intervall von 5:00 bis 6:00 Uhr ist und der Sonnenaufgang um 5:59 Uhr erfolgt, ist „isDaytime“ wahr.
relativeHumidity

integer

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

integer

Der prognostizierte UV-Index.
thunderstormProbability

integer

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

integer

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