Najczęstsze pytania dotyczące interfejsu Weather API

Informacje ogólne

Jak odróżnić interfejs Weather API od Google od specjalistycznych dostawców danych pogodowych?

Google integruje technologię przejętej przez nas renomowanej firmy pogodowej z postępami modeli AI MetNet i WeatherNext opracowanych przez Google DeepMind (2025 r.). Wykorzystuje to sprawdzoną niezawodność Google Maps Platform.

Jakie są różnice między danymi pogodowymi dostępnymi w Earth Engine i BigQuery a interfejsem Google Weather API?

Pakiet usług pogodowych Google oferuje kompleksową gamę rozwiązań dla różnych potrzeb. Modele WeatherNext (czyli GraphCast i GenCast) dostarczają nieprzetworzone wyniki prognozowe oparte na AI, w tym parametry idealne do badań, modelowania i analizy. Są one udostępniane za pomocą kodu źródłowego open source oraz historycznych lub bieżących zbiorów danych pogodowych przy użyciu interfejsów Earth Engine i BigQuery API.

Z kolei interfejs Weather API dostępny na Google Maps Platform dostarcza przetworzone dane dotyczące bieżących warunków pogodowych, prognozy godzinowe i dzienne, łącząc AI i tradycyjne systemy prognozowania w przyjaznym dla deweloperów formacie, który płynnie integruje się z aplikacjami i usługami sieciowymi. To podwójne podejście zaspokaja zarówno specjalistyczne potrzeby badawcze, jak i szerokie potrzeby deweloperów.

Dlaczego Google nie polega wyłącznie na pomiarach ze stacji pogodowych?

Google korzysta z różnych źródeł danych wejściowych na potrzeby swojego modelu predykcyjnego pogody, w tym z obserwacji ze stacji pogodowych, numerycznych modeli prognozowania pogody i modeli AI do prognozowania pogody. Powodem korzystania z tych różnych źródeł danych wejściowych jest to, że obserwacje ze stacji pogodowych dostarczają informacji o pogodzie tylko w lokalizacji stacji w czasie pomiaru. Obserwacje stacji pogodowych mogą być bardzo dokładne w konkretnym miejscu, ale zjawiska pogodowe, takie jak opady, zwłaszcza deszczu lub burzy, są często lokalne i mogą się znacznie różnić na krótkim dystansie.

Na przykład w miejscu, gdzie znajduje się stacja, może akurat padać ulewny deszcz, podczas gdy kilka kilometrów dalej jest 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.

Dodatkowo stacje pogodowe zwykle podają odczyty co godzinę lub co pół godziny. Nawet jeśli są one podawane w czasie zbliżonym do rzeczywistego, może wystąpić niewielkie opóźnienie między rzeczywistymi opadami a ich zgłoszeniem. Modele pomagają też w uzyskaniu aktualnych warunków, które są jak najbardziej zbliżone do rzeczywistości w miejscu, którego dotyczy zapytanie.

Wykorzystanie interfejsu API

Jaki jest zasięg interfejsu Weather API?

Interfejs Weather API obsługuje wszystkie kraje na całym świecie z wyjątkiem terytoriów objętych zakazem. W przypadku Japonii i Korei Południowej dane pogodowe są dostarczane przez firmę Weathernews Inc., która jest oficjalnie licencjonowanym operatorem usług meteorologicznych.

Jaka jest rozdzielczość przestrzenna interfejsu Google Weather API?

Rozdzielczość danych jest taka, że prognozy są tworzone w promieniu kilku kilometrów dla dowolnej lokalizacji na świecie.

Jaka jest częstotliwość aktualizacji interfejsu Weather API?

Punkt końcowy Aktualne warunki Prognoza godzinowa Prognoza dzienna Historia godzinowa
Częstotliwość odświeżania Obliczany w czasie rzeczywistym. Odświeżane co godzinę. Odświeżane co godzinę. Dwa razy dziennie (o 7:00 i 19:00 czasu pacyficznego).
  • Krótkoterminowe prognozy opadów (pierwsze 12 godzin prognozy): odświeżane co 2–15 minut przy użyciu radaru i modeli prognoz krótkoterminowych o wysokiej rozdzielczości.
  • Brak opadów i rozszerzony horyzont opadów (do 10 dni): odświeżane co godzinę, aby zapewnić najbardziej aktualne prognozy.

Czy interfejs Weather API udostępnia prognozę krótkoterminową opadów?

Google nie udostępnia w interfejsie API prognozy krótkoterminowej (prognozy minutowej), ale udostępnia bieżące warunki pogodowe, prognozy godzinowe i dzienne.

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

Indeks UV to pojedynczy indeks, który łączy promieniowanie UVA i UVB. Nie udostępniamy zestawienia według komponentów.

Jak interfejs Weather API generuje prognozę?

Jak pokazano na diagramie poniżej, prognozy Weather API są tworzone na podstawie wewnętrznego systemu prognozowania, który wykorzystuje modele pogodowe i obserwacje ze światowych agencji meteorologicznych jako dane wejściowe. Dane z publicznych czujników pogodowych są używane do ulepszania modelu prognozy.

Diagram modelu prognozy Weather API

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

Liczby w tabeli 1 porównują średnią kwadratową błędów (RMSE) w przypadku temperatury i prędkości wiatru w prognozie na 240 godzin (10 dni) między danymi pogodowymi Google a globalnymi i regionalnymi modelami pogodowymi instytucji państwowych w okresie 11 miesięcy (od 15 sierpnia 2024 r. do 1 lipca 2025 r.).

W ujęciu globalnym prognoza Pogody Google jest dokładniejsza niż prognozy wiodących instytucji państwowych. W przypadku Europy i Ameryki Północnej dane pogodowe Google zawierają mniej błędów niż najdokładniejsze regionalne modele rządowe, przynajmniej w późniejszej części horyzontu prognozy. Na szczególną uwagę zasługuje doskonała skuteczność danych pogodowych Google w przypadku dłuższych prognoz, które mogą być najtrudniejsze do dokładnego przewidzenia.

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

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

Temperatura Prędkość wiatru
Globalny
Ameryka Północna
Europa

Tabela 1. Średnie wartości RMSE dla poszczególnych kombinacji modeli regionalnych

Tabela 2 zawiera średnie wartości RMSE dla odpowiednich horyzontów prognozy dla każdego modelu (wartości Google są pogrubione). Parametry (temperatura, wiatr) i horyzonty prognozy, dla których Google ma najniższą średnią wartość RMSE, są wyróżnione ciemnozielonym kolorem. Parametry i horyzonty prognozy, dla których Google ma najniższą średnią wartość RMSE wraz z innymi modelami, są wyróżnione kolorem jasnozielonym.

Średnie wartości RMSE dla odpowiednich horyzontów prognozy Tabela 2. Średnie wartości RMSE dla odpowiednich horyzontów prognozy na model

Czy punkt końcowy danych historycznych odzwierciedla rzeczywiste dane pogodowe (tj. zweryfikowane przez lokalne pomiary)?

Historyczne dane pogodowe to głównie dane wyjściowe modelu. Chociaż uwzględnia on obserwacje z globalnych agencji meteorologicznych i numeryczne modele prognozowania pogody (NWP), są one asymilowane w modelu Pogody Google, aby tworzyć kompletne i spójne dane historyczne. Rzeczywiste pomiary stacji są uważane za „dane podstawowe” w określonych lokalizacjach, ale ich ograniczona globalna dystrybucja sprawia, że nie wystarczają do uzyskania pełnego obrazu sytuacji na całym świecie.

Te pola zawierają różne, ale powiązane informacje o opadach i ogólnej pogodzie.

  • weatherCondition: to pole zawiera ogólny, intuicyjny opis warunków pogodowych na wybranym obszarze, uwzględniający różne parametry, co ułatwia zrozumienie.
  • precipitation.probability.percent (PoP): to prawdopodobieństwo wystąpienia opadów. Prawdopodobieństwo wystąpienia opadów w lokalizacji prognozy w określonym przedziale czasu (zwykle co godzinę).
  • precipitation.qpf.quantity (QPF): to skrót od „quantitative precipitation forecast” (ilościowa prognoza opadów). Wskazuje oczekiwaną ilość opadów mierzoną jako głębokość (np. w milimetrach lub calach). Ta wartość pokazuje, ile opadów można się spodziewać, jeśli wystąpią w określonym czasie i miejscu.

Jak mogę sprawdzić, czy w danym miejscu pada deszcz?

Zalecamy użycie pola weatherCondition, aby dowiedzieć się, czy w danym miejscu pada deszcz. Deszcz może być sygnalizowany przez 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 wykrywanie 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 – na przykład jeśli interesują Cię tylko ulewne opady – możesz wybrać tylko odpowiedni podzbiór tych warunków.

Czy „aktualne warunki” odpowiadają obserwacjom w lokalizacjach stacji pogodowych? Jak określane są „aktualne warunki” w lokalizacjach bez stacji?

Nasze „aktualne warunki” dostarczają najbardziej aktualnych informacji o pogodzie dzięki połączeniu różnych źródeł danych, ale nie we wszystkich przypadkach są one ściśle równoważne bezpośrednim obserwacjom stacji.

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

Dzięki temu możemy podawać kompleksowe informacje o „aktualnych warunkach” nawet na obszarach, na których nie ma czujników, i zapewniać zawsze najlepsze dostępne informacje.

Limity i dostęp do interfejsu API

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?

Do korzystania z interfejsu Weather API wymagane jest 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 wyślę zapytanie o nieobsługiwaną lokalizację?

Jeśli szerokość i długość geograficzna nie znajdują się na liście obsługiwanych krajów, odpowiedź zwróci kod błędu 404 z komunikatem „Informacje są niedostępne dla tej lokalizacji. Wybierz inną lokalizację”.