Method: history.hours.lookup

Gibt bis zu 24 Stunden stündlicher historischer Wetterdaten für einen bestimmten Ort zurück, beginnend mit der letzten Stunde.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
location

object (LatLng)

Erforderlich. Der Standort, für den die stündlichen Verlaufsdaten 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).

pageSize

integer

Optional. Die maximale Anzahl der stündlichen Verlaufsdatensä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 letzten Stunde – ein Wert zwischen 1 und 24 (einschließlich). Der Standardwert ist der maximal zulässige Wert von 24.

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
{
  "historyHours": [
    {
      object (HistoryHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Felder
historyHours[]

object (HistoryHour)

Die stündlichen Verlaufsdaten 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

HistoryHour

Stellt einen stündlichen Verlaufsdatensatz 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), für das diese Verlaufsdaten gültig sind. Die Zeitstempel werden auf die nächste Stunde abgerundet.

displayDateTime

object (DateTime)

Das lokale Datum und die lokale Uhrzeit in der Zeitzone des Standorts (bürgerliche Zeit), für die dieser stündliche Datensatz 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 historischen Wetterbedingungen.

temperature

object (Temperature)

Die bisherige Temperatur.

feelsLikeTemperature

object (Temperature)

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

dewPoint

object (Temperature)

Der Verlauf der Taupunkttemperatur.

heatIndex

object (Temperature)

Die bisherige Hitzeindex-Temperatur.

windChill

object (Temperature)

Der historische Windchill-Faktor, die Lufttemperatur, die auf der Haut zu spüren ist.

wetBulbTemperature

object (Temperature)

Die historische Kühlgrenztemperatur, die niedrigste Temperatur, die durch verdunstendes Wasser erreicht werden kann.

precipitation

object (Precipitation)

Die historische Niederschlagswahrscheinlichkeit und die Niederschlagsmenge der letzten Stunde.

airPressure

object (AirPressure)

Die bisherigen Luftdruckbedingungen.

wind

object (Wind)

Die bisherigen Windbedingungen.

visibility

object (Visibility)

Die bisherige Sichtbarkeit.

iceThickness

object (IceThickness)

Die bisherige 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 historische Prozentsatz der relativen Luftfeuchtigkeit (Werte zwischen 0 und 100).

uvIndex

integer

Der bisherige UV-Index.

thunderstormProbability

integer

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

cloudCover

integer

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