Najczęstsze pytania dotyczące interfejsu Weather API

Informacje ogólne

Czym interfejs Weather API od Google różni się od interfejsów specjalistycznych dostawców danych pogodowych?

Google integruje technologię przejętej przez nas renomowanej firmy zajmującej się prognozowaniem pogody z postępami w zakresie modeli AI MetNetWeatherNext opracowanych przez Google DeepMind (2025 r.). Wykorzystuje to sprawdzoną niezawodność Google Maps Platform.

Jaka jest różnica między danymi pogodowymi dostępnymi w Earth Engine i BigQuery a interfejsem Google Weather API?

Pakiet usług pogodowych Google oferuje szeroką gamę rozwiązań dostosowanych do różnych potrzeb. Modele WeatherNext (czyli GraphCastGenCast) udostępniają surowe, oparte na AI wyniki prognozowania, w tym parametry idealne do badań, modelowania i analizy. Są one dostępne za pomocą kodu open source oraz historycznych lub bieżących zbiorów danych pogodowych z użyciem interfejsów API Earth Engine i BigQuery.

Z kolei interfejs Google Maps Platform Weather API dostarcza przetworzone dane pogodowe dotyczące bieżących warunków, prognoz godzinowych i prognoz dziennych, łącząc AI i tradycyjne systemy prognozowania w formacie przyjaznym dla deweloperów, który można bezproblemowo zintegrować z aplikacjami i usługami internetowymi. To dwutorowe podejście zaspokaja zarówno specjalistyczne potrzeby badawcze, jak i zapewnia szeroką dostępność dla deweloperów.

Dlaczego Google nie opiera się wyłącznie na pomiarach ze stacji pogodowych?

Google korzysta z różnych źródeł danych do tworzenia modelu pogodowego, w tym z obserwacji ze stacji meteorologicznych, numerycznych modeli prognozowania pogody i modeli AI do prognozowania pogody. Powodem korzystania z tych różnych źródeł danych jest to, że obserwacje ze stacji pogodowych dostarczają informacji o pogodzie tylko w miejscu, w którym znajduje się stacja, i w momencie pomiaru. Dane ze stacji pogodowych mogą być bardzo dokładne w odniesieniu do konkretnego miejsca, ale zjawiska pogodowe, takie jak opady, zwłaszcza podczas przelotnych deszczów lub burz, często mają charakter lokalny i mogą się znacznie różnić na niewielkim obszarze.

Na przykład w pobliżu stacji może padać ulewny deszcz, a kilka kilometrów dalej może być tylko lekka mżawka lub wcale nie padać. Odczyt z jednej stacji może nie być reprezentatywny dla większego obszaru, dlatego modele są niezbędne do dostarczania dodatkowych informacji między stacjami.

Stacje pogodowe zwykle podają odczyty co godzinę lub co pół godziny. Nawet jeśli są one dostarczane niemal w czasie rzeczywistym, może wystąpić niewielkie opóźnienie między rzeczywistymi opadami a ich zgłoszeniem. Modele pomagają też w określaniu aktualnych warunków w lokalizacji, o którą pytasz, tak aby były jak najbardziej zbliżone do rzeczywistości.

Wykorzystanie interfejsu API

Jaki jest zakres interfejsu Weather API?

Interfejs Weather API obsługuje wszystkie kraje na świecie z wyjątkiem Japonii, Korei i zakazanych terytoriów. Na początku będziemy obsługiwać obszary zaludnione (z wyjątkiem odległych lokalizacji, takich jak środek oceanu, pustynie i szczyty gór). W 2025 r. planujemy ciągłe ulepszanie rozdzielczości i jakości.

Jaka jest przestrzenna szczegółowość interfejsu Google Weather API?

Rozdzielczość danych jest taka, że prognozy są tworzone w odległości kilku kilometrów od dowolnej lokalizacji na świecie.

Jak często aktualizowany jest interfejs Weather API?

Punkt końcowy Aktualne warunki Prognoza godzinowa Prognoza dzienna Historia godzinowa
Częstotliwość odświeżania 15 minut (okresowo w ciągu godziny) 30 minut (okresowo w ciągu godziny) 30 minut (aktualizowane w tym samym czasie co prognoza godzinowa) Dwa razy dziennie (o 7:00 i 19:00 czasu pacyficznego).

Czy interfejs Weather API udostępnia prognozy opadów krótkoterminowych?

Interfejs API nie udostępnia prognozy krótkoterminowej (prognozy minutowej), ale zapewnia informacje o bieżących warunkach, prognozy godzinowe i dzienne.

Czy interfejs Weather API podaje oddzielne wartości UVA i UVB?

Indeks UV to pojedynczy indeks, który łączy promieniowanie UVA i UVB. Nie podajemy podziału na poszczególne komponenty.

Jak interfejs Weather API generuje prognozę?

Jak widać na diagramie poniżej, prognozy interfejsu Weather API są tworzone na podstawie wewnętrznego systemu prognozowania, który wykorzystuje modele pogodowe i obserwacje z globalnych agencji meteorologicznych. Dane z publicznych czujników pogodowych są wykorzystywane do ulepszania modelu prognozowania.

Diagram modelu prognozy interfejsu Weather API

Jaka jest dokładność prognozy pogody Google w różnych regionach i w różnych horyzontach czasowych w porównaniu z prognozami wiodących agencji rządowych zajmujących się pogodą?

Dane w tabeli 1 porównują średnią kwadratową błędów (RMSE) dla temperatury i prędkości wiatru w przypadku prognozy na 240 godzin (10 dni) w okresie 11 miesięcy (od 15 sierpnia 2024 r. do 1 lipca 2025 r.) w porównaniu z danymi pogodowymi Google oraz globalnymi i regionalnymi modelami pogodowymi agencji rządowych.

Prognozy pogody Google są lepsze niż prognozy wiodących agencji rządowych na całym świecie. W Europie i Ameryce Północnej dane pogodowe Google mają mniejszy błąd niż najdokładniejsze regionalne modele rządowe, przynajmniej w późniejszej części horyzontu prognozy. Szczególnie godna uwagi jest doskonała skuteczność danych pogodowych Google w przypadku prognoz długoterminowych, które są najtrudniejsze do dokładnego przewidzenia.

Tabela 1 zawiera średnie wartości RMSE dla wszystkich horyzontów prognozy odpowiednich dla każdej kombinacji modelu regionu. Niższa wartość RMSE oznacza lepszą skuteczność. Prognozy pogody Google mają najniższe lub jedne z najniższych średnich wartości RMSE w przypadku niemal wszystkich parametrów, regionów i zakresów horyzontu prognozy.

Kliknij obraz, aby wyświetlić jego powiększoną wersję.

Temperatura Prędkość wiatru
Cały świat
Ameryka Północna
Europa

Tabela 1. Średnie wartości RMSE dla każdej kombinacji modelu regionalnego

W tabeli 2 podano średnie wartości RMSE dla odpowiednich horyzontów prognozy w przypadku każdego modelu (wartości Google są pogrubione). Parametry (temperatura, wiatr) i horyzonty prognozy, w przypadku których Google ma najniższy średni RMSE, są wyróżnione ciemnozielonym kolorem. Parametry i horyzonty prognozy, dla których Google ma najniższy średni RMSE wraz z innymi modelami, są wyróżnione jasnym zielonym kolorem.

Średnie wartości RMSE dla odpowiednich horyzontów prognozy Tabela 2. Średnie wartości RMSE dla odpowiednich horyzontów prognozy w przypadku każdego modelu

Czy punkt końcowy danych historycznych odzwierciedla rzeczywiste dane pogodowe (czyli zweryfikowane na podstawie lokalnych pomiarów)?

Dane historyczne o pogodzie to głównie dane wygenerowane przez model. Chociaż uwzględnia obserwacje z globalnych agencji meteorologicznych i numeryczne modele prognozowania pogody (NWP), są one asymilowane w modelu Pogody Google, aby utworzyć pełny i spójny zapis historyczny. Rzeczywiste pomiary stacji są uważane za „prawdę podstawową” w określonych lokalizacjach, ale ich ograniczone rozmieszczenie na świecie sprawia, że nie wystarczają do uzyskania pełnego obrazu sytuacji na całym świecie.

Pola te dostarczają odrębnych, ale powiązanych ze sobą informacji o opadach i ogólnych warunkach pogodowych.

  • weatherCondition: to pole zawiera ogólny, intuicyjny opis ogólnych warunków pogodowych w zapytanym obszarze, uwzględniający różne parametry, aby ułatwić zrozumienie.
  • precipitation.probability.percent (PoP): to prawdopodobieństwo opadów. Prawdopodobieństwo wystąpienia opadów w lokalizacji prognozy w określonym przedziale czasu (zwykle godzinowym).
  • precipitation.qpf.quantity (QPF): to skrót od prognozy ilościowej opadów atmosferycznych. Określa oczekiwaną ilość opadów mierzoną jako głębokość (np. w milimetrach lub calach). Ta wartość określa, ile opadów można się spodziewać, jeśli wystąpią one w określonym czasie i miejscu.

Jak sprawdzić, czy w określonej lokalizacji pada deszcz?

Zalecamy używanie pola weatherCondition, aby sprawdzić, czy w danym miejscu pada deszcz. Na opady deszczu może wskazywać kilka warunków (RAIN, LIGHT RAIN, RAIN SHOWERS, HEAVY RAIN, WIND AND RAIN, THUNDERSTORM, HEAVY THUNDERSTORM, THUNDERSHOWER, SCATTERED SHOWERS, LIGHT THUNDERSTORM RAIN, SCATTERED THUNDERSTORMS, RAIN AND SNOW). Te warunki mają na celu rejestrowanie wszystkich przypadków lekkich, silnych, ciągłych lub rozproszonych opadów deszczu, a także odróżnianie deszczu od śniegu. W zależności od konkretnego przypadku użycia – np. jeśli dotyczy on tylko ulewnych deszczów – możesz użyć tylko odpowiedniego podzbioru tych warunków.

Czy „bieżące warunki” są równoznaczne z obserwacjami w lokalizacjach stacji pogodowych? Jak określane są „bieżące warunki” w lokalizacjach bez stacji?

Nasze „aktualne warunki” dostarczają najbardziej aktualnych informacji o pogodzie, ponieważ łączą różne źródła danych, ale nie zawsze są ściśle równoważne bezpośrednim obserwacjom stacji.

W przypadku wartości precipitation.probability.percentprecipitation.qpf.quantity (skumulowanych w ciągu ostatniej godziny) wartość podana w odpowiedzi currentConditions jest zawsze obliczana na podstawie najnowszej prognozy. Prawdopodobieństwo jest wartością modelowaną, a nie bezpośrednio obserwowaną.

Dzięki temu możemy dostarczać kompleksowe informacje o „bieżących warunkach” nawet na obszarach bez bezpośredniego zasięgu czujników, zapewniając w każdej chwili najlepsze dostępne informacje.

Ograniczenia interfejsu API i dostęp do niego

Czy interfejs API ma limit liczby żądań?

W przypadku interfejsu Weather API domyślny limit wynosi 6000 zapytań na minutę.

Czy mogę uzyskać dostęp do danych zbiorczo?

Dane zbiorcze są niedostępne. Możesz wysyłać zapytania do interfejsu Weather API w ramach limitu (6000 zapytań na minutę) i przestrzegać warunków buforowania określonych w Warunkach korzystania z usługi.

Czy muszę włączyć płatności?

Aby korzystać z interfejsu Weather API, musisz mieć ważne konto rozliczeniowe. Aby skonfigurować projekt z kontem rozliczeniowym, zapoznaj się z artykułem Włączanie płatności.

Co się stanie, jeśli zapytam o lokalizację, która nie jest obsługiwana?

Jeśli szerokość i długość geograficzna nie są objęte listą obsługiwanych krajów, odpowiedź zwróci kod błędu 404 z komunikatem „Informacje są niedostępne w tej lokalizacji”. Spróbuj w innym miejscu”.