Najczęstsze pytania dotyczące interfejsu Weather API

Informacje ogólne

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

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

Czym różnią się dane pogodowe dostępne w Earth Engine i BigQuery od Weather API od Google?

Pakiet usług pogodowych Google oferuje kompleksowy zakres rozwiązań dla różnych potrzeb. Modele WeatherNext (czyli GraphCast i GenCast) zapewniają surowe dane wyjściowe prognoz oparte na AI, w tym parametry idealne do badań, modelowania i analizy. Są one udostępniane na zasadach open source w postaci historycznych lub bieżących zbiorów danych pogodowych za pomocą interfejsów Earth Engine i BigQuery API.

Z kolei Weather API dostępny na Google Maps Platform dostarcza przetworzone dane pogodowe dotyczące bieżących warunków pogodowych, prognozy godzinowe i dzienne z wykorzystaniem zarówno opartych na AI modeli, jak i tradycyjnych systemów prognozowania w formacie przyjaznym dla deweloperów, 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 szeroką dostępność dla deweloperów.

Dlaczego Google nie opiera się tylko na pomiarach ze stacji meteorologicznych?

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

Na przykład w lokalizacji stacji może występować silna ulewa, a kilka kilometrów dalej może padać tylko lekki deszcz lub nie padać wcale. Ponieważ odczyt z jednej stacji może nie być reprezentatywny dla większego obszaru, modele są niezbędne do dostarczania dodatkowych informacji między stacjami.

Ponadto stacje meteorologiczne zwykle podają odczyty co godzinę lub 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 raportowaniem. Modele pomagają też w uzyskaniu bieżących warunków pogodowych jak najbardziej zbliżonych do rzeczywistych w danej lokalizacji.

Korzystanie z interfejsu API

Jaki jest zasięg Weather API?

Weather API obsługuje wszystkie kraje na świecie z wyjątkiem Japonii, Korei i objętych zakazem terytoriów. Na początku obsługujemy obszary zaludnione (z wyłączeniem odległych lokalizacji, takich jak środek oceanu, pustynie i szczyty górskie). Do 2025 r. planujemy ciągłe ulepszanie rozdzielczości i jakości.

Jaka jest rozdzielczość przestrzenna Weather API od Google?

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

Jaka jest częstotliwość aktualizacji Weather API?

Punkt końcowy Aktualne warunki Prognoza godzinowa Prognoza dzienna Dane historyczne w podziale na godziny
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) 2 razy dziennie (o 7:00 i 19:00 czasu pacyficznego).

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

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

Czy Weather API udostępnia oddzielne wartości UVA i UVB?

Indeks UV to pojedynczy indeks, który łączy zarówno UVA, jak i UVB. Nie udostępniamy podziału według komponentów.

Jak Weather API tworzy 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 z globalnych agencji meteorologicznych jako dane wejściowe. Dane z publicznych czujników pogodowych są używane do ulepszania modelu prognozy.

Diagram modelu prognozy interfejsu Weather API

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

Dane w tabeli 1 porównują średniokwadratowy błąd (RMSE) temperatury i prędkości wiatru w horyzoncie prognozowania 240 godzin (10 dni) między danymi pogodowymi Google a globalnymi i regionalnymi modelami pogodowymi agencji rządowych w ciągu 11 miesięcy (od 15 sierpnia 2024 r. do 1 lipca 2025 r.).

Na całym świecie prognoza pogody Google jest lepsza od prognoz wiodących agencji rządowych. 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 horyzontów prognozowania. Szczególnie godna uwagi jest doskonała skuteczność danych pogodowych Google w przypadku dłuższych horyzontów prognozowania, które mogą być najtrudniejsze do dokładnego przewidzenia.

Tabela 1 zawiera średnie wartości RMSE dla całych horyzontów prognozowania odpowiednich dla każdej kombinacji modelu regionalnego. 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 horyzontów prognozowania.

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

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

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

Tabela 2 zawiera średnie wartości RMSE dla odpowiednich horyzontów prognozowania dla każdego modelu (wartości Google są pogrubione). Parametry (temperatura, wiatr) i horyzonty prognozowania, w przypadku których Google ma najniższy średni RMSE, są wyróżnione ciemnozielonym kolorem. Parametry i horyzonty prognozowania, w przypadku których Google ma najniższy średni RMSE wraz z co najmniej 1 innym modelem, są wyróżnione jasnozielonym kolorem.

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

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

Historyczne dane pogodowe to przede wszystkim dane modelowane. Chociaż obejmują one obserwacje ze światowych agencji meteorologicznych i numeryczne modele prognozowania pogody (NWP), są one asymilowane w modelu pogodowym Google , aby utworzyć pełny i spójny zapis historyczny. Rzeczywiste pomiary ze stacji są uważane za „prawdę podstawową” w swoich lokalizacjach, ale ich ograniczona dystrybucja globalna sprawia, że nie wystarczają do uzyskania pełnego obrazu na całym świecie.

Te pola zawierają odrębne, ale powiązane informacje o opadach i ogólnej pogodzie.

  • weatherCondition: to pole zawiera ogólny, intuicyjny opis ogólnych warunków pogodowych w danym obszarze, uwzględniający różne parametry, co ułatwia 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 prognoza ilościowa opadów, która 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 danej lokalizacji pada deszcz?

Aby sprawdzić, czy w danej lokalizacji pada deszcz, zalecamy użycie pola weatherCondition. Wiele warunków może wskazywać na deszcz (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 uwzględnienie wszystkich przypadków lekkich, silnych, ciągłych lub rozproszonych opadów deszczu, a także odróżnienie deszczu od śniegu. W zależności od konkretnego przypadku użycia – na przykład jeśli bierzesz pod uwagę tylko silne opady deszczu – możesz użyć tylko odpowiedniego podzbioru tych warunków.

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

Nasze „bieżące warunki pogodowe” zawierają najbardziej aktualne informacje o pogodzie, które są połączeniem różnych źródeł danych, ale w niektórych przypadkach nie są one ściśle równoznaczne z bezpośrednimi obserwacjami ze stacji.

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

To podejście pozwala nam podawać kompleksowe „bieżące warunki pogodowe” nawet na obszarach bez bezpośredniego zasięgu czujników, co zapewnia najlepsze dostępne informacje.

Limity interfejsu API i dostęp

Czy interfejs API ma limit liczby żądań?

W przypadku Weather API domyślny limit liczby żądań wynosi 6000 zapytań na minutę.

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

Dane zbiorcze nie są dostępne. Możesz wysyłać zapytania do 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ć rozliczenia?

Aby korzystać z Weather API, musisz mieć prawidłowe konto rozliczeniowe. Aby skonfigurować projekt z kontem rozliczeniowym, przeczytaj artykuł Włączanie rozliczeń.

Co się stanie, jeśli wyślę zapytanie 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 o tej lokalizacji są niedostępne. Spróbuj innej lokalizacji”.