Method: history.hours.lookup

Hier finden Sie bis zu 24 Stunden stündliche Wetterdaten an einem bestimmten Ort, 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 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 der stündlichen Verlaufseinträge, 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 letzten Stunde abgerufen werden sollen. Die zulässigen Werte sind 1 bis 24. Der Standardwert ist der maximal zulässige Wert von 24.

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

object (HistoryHour)

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

HistoryHour

Stellt einen stündlichen Verlaufsdatensatz 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 Verlaufsdaten 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 Standorts (bürgerliche Zeit), für den 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 Zeitzonen-Offset.

weatherCondition

object (WeatherCondition)

Die Wetterbedingungen in der Vergangenheit.

temperature

object (Temperature)

Die bisherige Temperatur.

feelsLikeTemperature

object (Temperature)

Die gefühlte Temperatur am angeforderten Standort.

dewPoint

object (Temperature)

Die bisherige Taupunkttemperatur.

heatIndex

object (Temperature)

Die bisherige Hitzeindex-Temperatur.

windChill

object (Temperature)

Die gefühlte Temperatur, die Lufttemperatur, die auf die Haut trifft.

wetBulbTemperature

object (Temperature)

Die bisherige Kühlgrenztemperatur, die niedrigste Temperatur, die durch Verdampfen von Wasser erreicht werden kann.

precipitation

object (Precipitation)

Die bisherige Niederschlagswahrscheinlichkeit und die Niederschlagsmenge in 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

„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 prozentuale Wert der relativen Luftfeuchtigkeit in der Vergangenheit (Werte von 0 bis 100).

uvIndex

integer

Der bisherige UV-Index.

thunderstormProbability

integer

Die bisherige Gewitterwahrscheinlichkeit (Werte von 0 bis 100).

cloudCover

integer

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