Omówienie interfejsu Weather API

Weather API umożliwia wysyłanie żądań o hiperlokalne dane pogodowe w czasie rzeczywistym dla lokalizacji na całym świecie. Dane te mogą być wykorzystywane w panelach pogodowych, aplikacjach do aktualizowania pogody, nakładkach pogodowych na trasach oraz w monitorach aktywności opartych na pogodzie. Informacje o pogodzie obejmują m.in. aktualną temperaturę, opady, wilgotność względną, prędkość wiatru i indeks UV.

W przypadku lokalizacji o danej szerokości i długości geograficznej interfejs API udostępnia punkty końcowe (https://weather.googleapis.com/v1/...) dla danych z tabeli poniżej.

Punkty końcowe REST w skrócie

punkt końcowy API URL Opis Udokumentowane parametry
Aktualne warunki https://weather.googleapis.com/v1/currentConditions:lookup Aktualne warunki pogodowe location.latitude, location.longitude
Prognoza godzinowa https://weather.googleapis.com/v1/forecast/hours:lookup Prognoza warunków na okres do 240 godzin location.latitude, location.longitude
Prognoza dzienna https://weather.googleapis.com/v1/forecast/days:lookup prognozę pogody na maksymalnie 10 dni, location.latitude, location.longitude
Historia godzinowa https://weather.googleapis.com/v1/history/hours:lookup Do 24 godzin zapisanych w pamięci podręcznej danych o warunkach w przeszłości location.latitude, location.longitude
Alerty pogodowe https://weather.googleapis.com/v1/publicAlerts:lookup Alerty pogodowe key, location.latitude, location.longitude

Częste przypadki użycia

Funkcje interfejsu Weather API

Dane interfejsu Weather API obejmują:

  • Warunki pogodowe i ikony: opis i odpowiednia ikona wskazująca aktualne warunki pogodowe (np. „Pochmurno” lub „Przelotne opady śniegu”) w weatherCondition.
  • Temperatura: aktualna temperatura (temperature), temperatura minimalna i maksymalna (minTemperature i maxTemperature w prognozach dziennych lub w currentConditionsHistory) oraz temperatura odczuwalna (feelsLikeTemperature).
  • Opady: całkowite opady i rodzaj opadów (śnieg, deszcz, lód, mieszane).
  • Wiatr: temperatura odczuwalna (windChill), kierunek wiatru (wind.direction), prędkość wiatru (wind.speed) i porywy (wind.gust).
  • Grubość lodu: grubość lodu.
  • Wilgotność: punkt rosy (dewPoint), indeks cieplny (heatIndex), temperatura mokrego termometru (wetBulbTemperature) i wilgotność względna (relativeHumidity).
  • Indeks UV: indeks promieniowania ultrafioletowego (UV) (uvIndex).
  • Prawdopodobieństwo burzy: procentowe prawdopodobieństwo wystąpienia burzy.
  • Widoczność: odległość, z której obiekt jest wyraźnie widoczny.
  • Ciśnienie powietrza: średnie ciśnienie powietrza na poziomie morza.
  • Zdarzenia związane ze słońcem i księżycem: godziny wschodu i zachodu słońca oraz wschodu i zachodu księżyca.
  • Zachmurzenie: odsetek nieba pokrytego chmurami.

Jak korzystać z interfejsu Weather API

1 Konfiguracja Zacznij od sekcji Skonfiguruj projekt Google Cloud i wykonaj podane w niej instrukcje.
2 Sprawdzanie aktualnych warunków Zobacz Sprawdzanie bieżących warunków.
3 Prognoza godzinowa Zobacz Sprawdzanie prognozy godzinowej.
4 Sprawdzanie prognozy dziennej Zobacz Sprawdzanie prognozy dziennej.
5 Pobieranie historii godzinowej Zobacz Pobieranie historii godzinowej.
6 Otrzymywanie alertów pogodowych Zobacz Otrzymywanie alertów pogodowych.

W przypadku indeksu jakości powietrza (AQI) i zanieczyszczeń pyłowych (PM2, 5, PM10) użyj interfejsu Air Quality API (https://airquality.googleapis.com/v1/currentConditions:lookup). Interfejs Weather API nie zwraca tych wartości.

Inne powiązane interfejsy API dotyczące środowiska:

  • Stężenie pyłków: Pollen API (https://pollen.googleapis.com/v1/forecast:lookup)
  • Promieniowanie słoneczne i potencjał dachu: Solar API (https://solar.googleapis.com/v1/buildingInsights:findClosest)

Co dalej?