Method: forecast.hours.lookup

Zwraca prognozy godzinne dla danej lokalizacji na okres do 240 godzin, licząc od bieżącej godziny.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
location

object (LatLng)

Wymagane. Lokalizacja, dla której chcesz uzyskać prognozę godzinową.
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 prognoz godzinowych 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 bieżącej godziny – wartość od 1 do 240 (włącznie). Domyślna jest maksymalna dozwolona wartość 240.
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 
{
  "forecastHours": [
    {
      object (ForecastHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Pola
forecastHours[]

object (ForecastHour)

prognozy godzinowej, zgodnie z liczbą godzin i rozmiarem strony określonymi 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

ForecastHour

Reprezentuje rekord godzinnej prognozy pogody 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)

1-godzinny przedział czasu (wg czasu UTC), w którym te dane prognozy są ważne (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 tę prognozę godzinową. 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)

Prognozowana pogoda.
temperature

object (Temperature)

prognozowana temperatura,
feelsLikeTemperature

object (Temperature)

Pomiar odczuwalnej temperatury w wybranym miejscu.
dewPoint

object (Temperature)

Przewidywana temperatura punktu rosy.
heatIndex

object (Temperature)

prognozowana temperatura temperatury odczuwalnej;
windChill

object (Temperature)

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

object (Temperature)

Prognozowana temperatura mokrego termometru, czyli najniższa temperatura osiągalna przez parowanie wody.
precipitation

object (Precipitation)

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

object (AirPressure)

prognozowane ciśnienie atmosferyczne;
wind

object (Wind)

prognozowane warunki wiatrowe.
visibility

object (Visibility)

Prognozowana widoczność.
iceThickness

object (IceThickness)

Prognozowana 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

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

integer

prognozowany indeks ultrafioletu (UV);
thunderstormProbability

integer

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

integer

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