Method: forecast.hours.lookup

Zwraca prognozy godzinowe dla danej lokalizacji z wyprzedzeniem do 240 godzin, począwszy 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, 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 rekordów prognozy godzinowej do zwrócenia na stronie – wartość z zakresu 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, począwszy od bieżącej godziny – wartość z zakresu od 1 do 240 (włącznie). Domyślna wartość to maksymalna dozwolona wartość 240.
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 
{
  "forecastHours": [
    {
      object (ForecastHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Pola
forecastHours[]

object (ForecastHour)

Prognozy godzinowe są rejestrowane 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

ForecastHour

Reprezentuje rekord prognozy 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 prognozy 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 obliczana jest prognoza godzinowa. 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)

Prognozowane warunki pogodowe.
temperature

object (Temperature)

prognozowana temperatura,
feelsLikeTemperature

object (Temperature)

Informacja o tym, jaka będzie odczuwalna temperatura w wybranej lokalizacji.
dewPoint

object (Temperature)

Prognozowana temperatura punktu rosy.
heatIndex

object (Temperature)

prognozowana temperatura odczuwalna,
windChill

object (Temperature)

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

object (Temperature)

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

object (Precipitation)

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

object (AirPressure)

Prognozowane warunki ciśnienia powietrza.
wind

object (Wind)

Prognozowane warunki wiatrowe.
visibility

object (Visibility)

Prognozowana widoczność.
iceThickness

object (IceThickness)

Prognozowana 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

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

integer

Prognozowany indeks UV.
thunderstormProbability

integer

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

integer

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