Najczęstsze pytania dotyczące interfejsu Weather API

Informacje ogólne

Czym różni się interfejs Weather API od Google od usług wyspecjalizowanych 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 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 kompleksowy zakres rozwiązań dla różnych potrzeb. Modele WeatherNext (czyli GraphCast i GenCast) dostarczają nieprzetworzone wyniki prognozowe oparte na AI, w tym parametry, które znakomicie sprawdzają się przy prowadzeniu badań, modelowaniu i analizie. Są one udostępniane na zasadach open source w postaci historycznych lub bieżących zbiorów danych pogodowych za pomocą interfejsów API Earth Engine i BigQuery.

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 zapewnia szeroki dostęp dla deweloperów.

Dlaczego Google nie opiera się tylko 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 wejściowych jest to, że obserwacje ze stacji pogodowych dostarczają informacji o pogodzie tylko w lokalizacji stacji w momencie pomiaru. Dane ze stacji pogodowych mogą być bardzo dokładne w określonym miejscu, ale zjawiska pogodowe, takie jak opady, zwłaszcza z przelotnych deszczów lub burz, są często lokalne i mogą się znacznie różnić na krótkim odcinku.

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 nie padać wcale. 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 w czasie zbliżonym do rzeczywistego, może wystąpić niewielkie opóźnienie między rzeczywistymi opadami a ich zgłoszeniem. Modele pomagają też jak najdokładniej określić aktualne warunki w miejscu, w którym użytkownik wysyła zapytanie.

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. W początkowej fazie wprowadzania usługi obsługujemy obszary zaludnione (z wyjątkiem odległych lokalizacji, takich jak środek oceanu, pustynie i szczyty gór). W 2025 r. planujemy dalsze ulepszanie rozdzielczości i jakości.

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

Rozdzielczość danych jest na tyle wysoka, że prognozy są tworzone w odległości kilku kilometrów od 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 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 prognozę krótkoterminową opadów?

Interfejs API nie udostępnia prognozy krótkoterminowej (prognozy minutowej), ale zapewnia informacje o bieżących warunkach pogodowych, 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 podajemy szczegółowych informacji o poszczególnych komponentach.

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 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 240-godzinnej (10-dniowej) na podstawie danych pogodowych Google oraz globalnych i regionalnych modeli pogodowych agencji rządowych w ciągu 11 miesięcy (od 15 sierpnia 2024 r. do 1 lipca 2025 r.).

Prognozy pogody Google są lepsze niż prognozy wiodących agencji rządowych na całym świecie. W przypadku Europy i Ameryki 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 dłuższych horyzontów prognozy, które mogą być 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 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 odpowiednich kombinacji modeli regionalnych

Tabela 2 zawiera ś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 błąd RMSE, są wyróżnione ciemnozielonym kolorem. Parametry i horyzonty prognozy, dla których Google ma najniższy średni błąd 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 (tzn. zweryfikowane na podstawie pomiarów lokalnych)?

Historyczne dane pogodowe to głównie dane wyjściowe modelu. Chociaż uwzględnia obserwacje światowych 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ą uznawane 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.

Te pola zawierają różne, ale powiązane informacje o opadach i ogólnych warunkach pogodowych.

  • weatherCondition: to pole zawiera ogólny, intuicyjny opis warunków pogodowych na wybranym obszarze, uwzględniający różne parametry, aby ułatwić zrozumienie.
  • precipitation.probability.percent (PoP): oznacza prawdopodobieństwo wystąpienia opadów. Prawdopodobieństwo wystąpienia opadów w miejscu prognozy w określonym przedziale czasu (zwykle godzinowym).
  • 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ść określa, ile opadów można się spodziewać, jeśli wystąpią one w określonym czasie i miejscu.

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

Zalecamy używanie pola weatherCondition, aby sprawdzić, 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 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 bierzesz pod uwagę tylko ulewne deszcze – możesz użyć tylko odpowiedniego podzbioru tych warunków.

Czy „bieżące 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, 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.percent i precipitation.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 „aktualnych warunkach” nawet na obszarach bez bezpośredniego pokrycia czujnikami, 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 to 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 zgodnie z warunkami buforowania określonymi 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 za pomocą konta rozliczeniowego, 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ą uwzględnione na liście obsługiwanych krajów, w odpowiedzi zostanie zwrócony kod błędu 404 z komunikatem „Informacje są niedostępne w tej lokalizacji”. Wybierz inną lokalizację."