Method: history.hours.lookup

Zwraca dane historyczne dotyczące pogody w podziale na godziny z ostatnich 24 godzin w danym miejscu, zaczynając od ostatniej godziny.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
location

object (LatLng)

Wymagane. Lokalizacja, dla której chcesz uzyskać godzinowe dane historyczne.
unitsSystem

enum (UnitsSystem)

Opcjonalnie: System jednostek, który ma być używany w przypadku zwracanych warunków pogodowych. Jeśli nie podasz tego parametru, zwrócone warunki pogodowe będą podane w systemie metrycznym (domyślnie = METRIC).
pageSize

integer

Opcjonalnie: Maksymalna liczba historycznych rekordów godzinowych do zwrócenia na stronie – wartość od 1 do 24 (włącznie). Wartością domyślną jest maksymalna dozwolona wartość 24.
pageToken

string

Opcjonalnie: Token strony otrzymany z poprzedniego żądania. Służy do pobierania następnej strony.
hours

integer

Opcjonalnie: Ogranicza liczbę godzin do pobrania, zaczynając od ostatniej godziny – od 1 do 24 (włącznie). Wartością domyślną jest maksymalna dozwolona wartość 24.
languageCode

string

Opcjonalnie: Umożliwia klientowi wybór języka odpowiedzi. Jeśli dane nie mogą zostać podane w danym języku, interfejs API używa najbliższego dopasowania. Dozwolone wartości są zgodne ze standardem IETF BCP-47. Wartość domyślna to „en”.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na wywołanie RPC hours.lookup.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "historyHours": [
    {
      object (HistoryHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Pola
historyHours[]

object (HistoryHour)

Godzinowe rekordy historyczne zgodnie z liczbą godzin i rozmiarem strony określonymi w żądaniu.
timeZone

object (TimeZone)

Strefa czasowa w żądanej lokalizacji.
nextPageToken

string

Token do pobrania następnej strony.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

HistoryHour

Reprezentuje rekord historii godzinowej w danej lokalizacji.

Zapis JSON 
{
  "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
}
Pola
interval

object (Interval)

Jednogodzinny przedział (w czasie UTC), w którym te dane historyczne są ważne (sygnatury czasowe są zaokrąglane w dół do najbliższej godziny).
displayDateTime

object (DateTime)

Lokalna data i godzina w strefie czasowej lokalizacji (czas cywilny), dla której obliczono ten godzinowy rekord. To pole może być używane do wyświetlania informacji na urządzeniu klienta. Uwaga: ta data będzie zawierać rok, miesiąc, dzień, godzinę i przesunięcie względem czasu UTC.
weatherCondition

object (WeatherCondition)

historyczne warunki pogodowe;
temperature

object (Temperature)

historyczna temperatura,
feelsLikeTemperature

object (Temperature)

Miara tego, jak odczuwalna jest temperatura w wybranej lokalizacji.
dewPoint

object (Temperature)

historyczna temperatura punktu rosy,
heatIndex

object (Temperature)

historyczna temperatura wskaźnika ciepła,
windChill

object (Temperature)

Historyczna temperatura odczuwalna, czyli temperatura powietrza odczuwana na skórze.
wetBulbTemperature

object (Temperature)

Historyczna temperatura mokrego termometru, czyli najniższa temperatura, jaką można osiągnąć przez odparowanie wody.
precipitation

object (Precipitation)

Prawdopodobieństwo wystąpienia opadów w przeszłości i ilość opadów w ciągu ostatniej godziny.
airPressure

object (AirPressure)

Historyczne warunki ciśnienia atmosferycznego.
wind

object (Wind)

historyczne warunki wiatrowe;
visibility

object (Visibility)

Widoczność historyczna.
iceThickness

object (IceThickness)

historyczna grubość lodu;
isDaytime

boolean

Wartość „prawda”, jeśli ta godzina przypada między lokalnym wschodem słońca (włącznie) a zachodem słońca (wyłącznie). W przeciwnym razie jest noc (między zachodem słońca a następnym wschodem). Uwaga: ta godzina będzie traktowana jako pora dzienna lub nocna, jeśli przedział czasu pokrywa się odpowiednio z lokalną godziną wschodu i zachodu słońca (np. jeśli przedział czasu to 5:00–6:00, a wschód słońca następuje o 5:59, to isDaytime będzie mieć wartość „true”).
relativeHumidity

integer

Historyczny procent wilgotności względnej (wartości od 0 do 100).
uvIndex

integer

Historyczny indeks UV.
thunderstormProbability

integer

Historyczne prawdopodobieństwo wystąpienia burzy (wartości od 0 do 100).
cloudCover

integer

Historyczny odsetek nieba pokrytego chmurami (wartości od 0 do 100).