Method: history.hours.lookup

Zwraca do 24 godzin historycznych danych pogodowych w danej lokalizacji, począwszy 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 mają być pobierane historyczne dane godzinowe.
unitsSystem

enum (UnitsSystem)

Opcjonalnie: System jednostek do zastosowania w przypadku zwracanych warunków pogodowych. Jeśli nie podasz tej wartości, zwrócone warunki pogodowe będą podane w systemie metrycznym (domyślnie = METRIC).
pageSize

integer

Opcjonalnie: Maksymalna liczba godzinowych rekordów historycznych do zwrócenia na stronę – wartość od 1 do 24 (włącznie). Wartość domyślna to maksymalna dozwolona wartość 24.
pageToken

string

Opcjonalnie: Token strony otrzymany z poprzedniego żądania. Służy do pobierania kolejnych stron.
hours

integer

Opcjonalnie: Ogranicza łączną liczbę godzin do pobrania, licząc od ostatniej godziny – od 1 do 24 (włącznie). Wartość domyślna to maksymalna dozwolona wartość 24.
languageCode

string

Opcjonalnie: Umożliwia klientowi wybór języka odpowiedzi. Jeśli nie można podać danych w tym języku, interfejs API stosuje najbliższe dopasowanie. Dozwolone wartości są zgodne ze standardem IETF BCP-47. Wartość domyślna to „pl”.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź dla wywołania 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)

Godzinne rekordy historyczne według liczby godzin i rozmiaru strony określonych w żądaniu.
timeZone

object (TimeZone)

Strefa czasowa w wybranym miejscu.
nextPageToken

string

Token do pobierania następnej strony.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

HistoryHour

Reprezentuje godzinny rekord historii w konkretnej 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)

1-godzinny przedział (według czasu UTC), w którym te dane historyczne są dostępne (sygnatura czasowa jest zaokrąglana w dół do najbliższej godziny).
displayDateTime

object (DateTime)

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

object (WeatherCondition)

historyczne warunki pogodowe;
temperature

object (Temperature)

historyczną temperaturę,
feelsLikeTemperature

object (Temperature)

Pomiar temperatury odczuwalnej 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 osiągalna przez parowanie wody.
precipitation

object (Precipitation)

Historyczne prawdopodobieństwo opadów i ich ilość nagromadzona w ciągu ostatniej godziny.
airPressure

object (AirPressure)

historyczne wartości ciśnienia powietrza,
wind

object (Wind)

historyczne warunki wiatrowe.
visibility

object (Visibility)

Widoczność historyczna.
iceThickness

object (IceThickness)

historyczna grubość lodu;
isDaytime

boolean

Prawda, jeśli ta godzina jest zawarta między lokalnym wschodem słońca (włącznie) a zachodem słońca (wyłącznie). W przeciwnym razie jest noc (między zachodem a kolejnym wschodem słońca). Uwaga: ta godzina będzie uważana za dzień lub noc, jeśli przedział będzie się pokrywać z miejscowym wschodem i zachodem słońca (np. jeśli przedział będzie obejmować godziny od 5:00 do 6:00, a słońce wschodzi o 5:59, to isDaytime będzie miał wartość true).
relativeHumidity

integer

Historyczna wartość względnej wilgotności w procentach (wartości od 0 do 100).
uvIndex

integer

Historyczny indeks ultrafioletowy (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).