Otrzymywanie alertów pogodowych

Punkt końcowy publicAlerts zawiera szczegółowe informacje o alertach dotyczących konkretnych zjawisk pogodowych wydawanych przez wiarygodne agencje krajowe i międzynarodowe. Te alerty dostarczają kluczowych, potencjalnie ratujących życie informacji.

Punkt końcowy zwraca alerty pogodowe w czasie rzeczywistym dla danej szerokości i długości geograficznej. Obsługiwane zdarzenia pogodowe to:

  • Opady: deszcz, śnieg, grad, susze i inne
  • Ekstremalne temperatury: zimno, upał, mróz, przymrozek, temperatura odczuwalna i wilgotność
  • Wiatr i burze: zamiecie śnieżne, huragany, tornada, burze tropikalne, burze z wyładowaniami atmosferycznymi itp.
  • Ograniczenia widoczności: mgła, burze pyłowe i zamiecie śnieżne.
  • Zagrożenia związane z wodą: powodzie, tsunami, fale sztormowe, zagrożenia przybrzeżne i inne
  • Zdarzenia geofizyczne i geologiczne: trzęsienia ziemi, osuwiska i aktywność wulkaniczna.
  • Pożary: pożary lasów, warunki sprzyjające pożarom i inne

Pełną listę obsługiwanych zdarzeń pogodowych znajdziesz w artykule Typy zdarzeń pogodowych.

Alerty mogą zawierać zlokalizowane opisy lub nie, w zależności od tego, co jest dostępne w źródle danych. Ze względu na ograniczenia źródła danych informacje są wyświetlane w niezmienionej formie (surowe treści). Więcej informacji o źródłach alertów pogodowych znajdziesz w sekcji Źródła danych.

W przypadku danego alertu pogodowego interfejs API zwraca te informacje:

  • Rodzaj zjawiska pogodowego powiązanego z alertem.
  • Lista obszarów, których to dotyczy, wraz ze współrzędnymi określającymi granice geograficzne tych obszarów.
  • Podsumowanie zjawiska pogodowego w 1 zdaniu
  • Poziomy ważności, pewności i pilności
  • Opis instrukcji dotyczących działań zalecanych w przypadku docelowych odbiorców
  • Zalecenia dotyczące bezpieczeństwa
  • Czas rozpoczęcia i zakończenia alertu
  • Nazwa i witryna organu publikującego

Narzędzie APIs Explorer umożliwia wysyłanie żądań w czasie rzeczywistym, dzięki czemu możesz zapoznać się z interfejsem API i jego opcjami:

Informacje o prośbach o alerty pogodowe

Aby poprosić o informacje o alertach pogodowych, wyślij żądanie GET HTTP na adres:

https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE

W parametrach adresu URL żądania podaj współrzędne szerokości i długości geograficznej lokalizacji.

Informacje o odpowiedziach na alerty pogodowe

Interfejs Weather API zwraca w treści odpowiedzi te pola:

Pole Typ Opis Wymagana czy opcjonalna
alertId Ciąg znaków Identyfikator alertu. Możesz je też znaleźć na stronie dostawcy danych. Wymagane
alertTitle Ciąg znaków Tytuł alertu opisujący zdarzenie pogodowe.

Uwaga: jest to jedyny ciąg znaków, który jest tłumaczony, gdy w żądaniu znajduje się parametr kodu języka.		 Wymagane
eventType Typ wyliczeniowy Rodzaj zjawiska pogodowego powiązanego z alertem.

Pełną listę obsługiwanych zjawisk pogodowych znajdziesz w sekcji Typy zjawisk pogodowych.		 Wymagane
areaName Ciąg znaków Nazwa obszaru geograficznego, którego dotyczy alert, w tym żądana lokalizacja. Wymagane
polygon Ciąg znaków Współrzędne określające zamknięty obszar alertu. Opcjonalny
description Ciąg znaków Krótkie wyrażenie podsumowujące opis wydarzenia w określonym języku (np. „Ostrzeżenie przed tornadem”). Opcjonalny
severity Typ wyliczeniowy Poziom ważności alertu:
  • Krytyczne: nadzwyczajne zagrożenie życia lub mienia
  • Poważne: znaczne zagrożenie życia lub mienia
  • Umiarkowane: potencjalne zagrożenie dla życia i bezpieczeństwa mienia
  • Niewielkie: minimalne lub brak znanych zagrożeń dla życia i bezpieczeństwa mienia.
  • Nieznany: poziom ważności nieznany
 Opcjonalny
certainty Typ wyliczeniowy Poziom pewności alertu:
  • Obserwowane: zdarzenie, które wystąpiło lub trwa.
  • Bardzo prawdopodobne: bardzo prawdopodobne, że wystąpiło lub trwa
  • Prawdopodobne: prawdopodobne (p > ~50%), że zdarzenie miało miejsce lub nadal trwa.
  • Możliwe: możliwe, ale mało prawdopodobne, że wystąpiło lub nadal występuje (p <= ~50%).
  • Mało prawdopodobne: nie oczekuje się, że wystąpi (p ≈ 0).
  • Nieznany: pewność nieznana
 Opcjonalny
urgency Typ wyliczeniowy Poziom pilności alertu:
  • Natychmiastowe: należy natychmiast podjąć odpowiednie działania.
  • Oczekiwane działanie: należy podjąć odpowiednie działania w krótkim czasie (w ciągu najbliższej godziny).
  • Przyszłość: w najbliższej przyszłości NALEŻY podjąć odpowiednie działania.
  • Przeszłość: nie musisz już podejmować żadnych działań.
  • Nieznany: pilność nieznana
 Opcjonalny
instruction Ciąg znaków Opis instrukcji dotyczących reklamy adaptacyjnej z wezwaniem do działania dla docelowych odbiorców. Opcjonalny
safetyRecommendations Ciąg znaków Rekomendacje dotyczące bezpieczeństwa na podstawie kodów organów publicznych. Zawiera dyrektywy najwyższego poziomu i podtekst z dodatkowymi informacjami. Opcjonalny
timezoneOffset Ciąg znaków Przesunięcie strefy czasowej zdarzenia w formacie +/-GG:MM. Wymagane
startTime DateTime Data i godzina (czas UTC) informacji w wiadomości z alertem. Opcjonalny
expirationTime DateTime Data i godzina (czas UTC), kiedy alert ma się zakończyć. W przypadku wydarzeń o nieokreślonym czasie trwania może mieć wartość null. W takim przypadku nagłówek będzie wskazywać, że wydarzenie „jest w trakcie”. Opcjonalny
dataSource Typ wyliczeniowy Szczegóły organu, w tym wydawca, nazwa i adres URL. Wymagane
regionCode Typ wyliczeniowy Kod regionu lokalizacji, której dotyczy żądanie. Opcjonalny

Źródła danych

Punkt końcowy alertów pogodowych zwraca dane opublikowane przez dostawców wymienionych w tabeli poniżej. Na podstawie współrzędnych geograficznych podanych w żądaniu treść odpowiedzi zawiera dane z odpowiedniego lokalnego organu.

Usługodawcy uwzględnieni w kanale przestrzegają wytycznych dotyczących komunikatów alarmowych Google. Google może w każdej chwili zaktualizować listę dostawców.

Kraj Agencja
Australia ACT Emergency Services Agency (ACT ESA)
New South Wales Rural Fire Service (NSW RFS)
South Australian Country Fire Service (SA CFS)
Tasmania Fire Service (TFS)
Queensland Fire and Emergency Services (QFES)
Austria GeoSphere Austria za pośrednictwem MeteoAlarm
Belgia Królewski Instytut Meteorologiczny Belgii za pośrednictwem MeteoAlarm
Bośnia i Hercegowina Federalny Instytut Hydrologiczno-Meteorologiczny (FHMZ) za pośrednictwem MeteoAlarm
Bułgaria National Institute of Meteorology & Hydrology za pośrednictwem MeteoAlarm
Brazylia Centro Nacional de Gerenciamento de Riscos e Desastres (CENAD)
Instituto Nacional de Meteorologia (INMET)
Kolumbia Unidad Nacional para la Gestión del Riesgo de Desastres (UNGRD)
Wybrzeże Kości Słoniowej Société d'Exploitation et de Développement Aéroportuaire, Aéronautique et Météorologique
Chorwacja Chorwacka Służba Meteorologiczna i Hydrologiczna za pośrednictwem MeteoAlarm
Cypr Departament Meteorologii za pośrednictwem MeteoAlarm
Czechy Czeski Instytut Hydrometeorologiczny za pośrednictwem MeteoAlarm
Dania Duński Instytut Hydrometeorologiczny za pośrednictwem MeteoAlarm
Ekwador Instituto Nacional de Meteorología e Hidrología
Estonia Ministerstwo Klimatu za pośrednictwem MeteoAlarm
Finlandia Fiński Instytut Meteorologiczny za pośrednictwem MeteoAlarm
Francja Météo-France za pośrednictwem MeteoAlarm
Niemcy DWD – Niemiecka Służba Meteorologiczna
Ghana Agence Nationale de la Météorologie
Grecja Grecka Narodowa Służba Meteorologiczna (EMY) za pośrednictwem MeteoAlarm
Węgry HungaroMet Nonprofit Zrt za pośrednictwem MeteoAlarm
Islandia Islandzki Urząd Meteorologiczny za pośrednictwem MeteoAlarm
Irlandia Met Eirann za pośrednictwem MeteoAlarm
Włochy Włoska Służba Meteorologiczna za pośrednictwem MeteoAlarm
Jamajka Służba Meteorologiczna Jamajki
Japonia Japońska Agencja Meteorologiczna (JMA)
Łotwa Łotewskie Centrum Środowiska, Geologii i Meteorologii za pośrednictwem MeteoAlarm
Litwa Litewska Służba Hydrometeorologiczna za pośrednictwem MeteoAlarm
Luksemburg MeteoLux za pośrednictwem MeteoAlarm
Madagaskar Météo Madagascar
Meksyk Centro de Instrumentación y Registro Sísmico A.C. (CIRES)
Holandia Królewski Niderlandzki Instytut Meteorologiczny za pośrednictwem MeteoAlarm
Macedonia Północna Krajowa Służba Hydrometeorologiczna za pośrednictwem MeteoAlarm
Norwegia Norweski Instytut Meteorologiczny za pośrednictwem MeteoAlarm
Nowa Zelandia GNS Science (GeoNet)
MetService
Filipiny Filipińska Administracja Służb Atmosferycznych, Geofizycznych i Astronomicznych (PAGASA)
Polska Instytut Meteorologii i Gospodarki Wodnej za pośrednictwem MeteoAlarm
Portugalia Portugalski Instytut Morski i Atmosferyczny za pośrednictwem MeteoAlarm
Rumunia Narodowa Administracja Meteorologiczna za pośrednictwem MeteoAlarm
Serbia Instytut Hydrometeorologiczny Republiki Serbii za pośrednictwem MeteoAlarm
Singapur Służba Meteorologiczna Singapuru
Słowacja Słowacki Instytut Hydrometeorologiczny za pośrednictwem MeteoAlarm
Słowenia Hydrometeorologiczny Instytut Słowenii za pośrednictwem MeteoAlarm
Wyspy Salomona Służby Meteorologiczne Wysp Salomona
Korea Południowa Koreańska Administracja Meteorologiczna
Hiszpania Państwowa Agencja Meteorologiczna za pośrednictwem MeteoAlarm
Szwecja Szwedzki Instytut Meteorologiczny i Hydrologiczny za pośrednictwem MeteoAlarm
Szwajcaria Federalny Urząd Meteorologii i Klimatologii MeteoSwiss za pośrednictwem MeteoAlarm
Tajwan Narodowe Centrum Nauki i Technologii ds. Redukcji Skutków Katastrof (NCDR)
Tajlandia Tajski Departament Meteorologiczny
Wielka Brytania Met Office za pośrednictwem MeteoAlarm
Agencja Środowiska w Wielkiej Brytanii
Stany Zjednoczone Narodowe Centrum Ostrzegania przed Tsunami
Narodowa Służba Pogodowa Stanów Zjednoczonych
Wietnam Narodowe Centrum Prognozowania Hydrometeorologicznego

Atrybucja

Na wszystkich ekranach, na których prezentowane są dane, aplikacja klienta musi zawierać atrybucję do pierwotnego źródła za pomocą pola dataSource:

"dataSource": {
        "publisher": "NOAA",
        "name": "National Weather Service",
        "authorityUri": "https://www.weather.gov/"
      }

Atrybucja musi zawierać pełną nazwę źródła danych (podaną w polu name) i hiperlink do źródła danych z użyciem adresu URL podanego w polu authorityUri (np. „National Weather Service”).

Typy zdarzeń pogodowych

Obsługiwane są te typy zdarzeń pogodowych:

Typy zdarzeń pogodowych
ACID_RAIN
AVALANCHE
BLIZZARD
BLOWING_SNOW
COASTAL_FLOOD
COASTAL_HAZARD
COLD
CYCLONE
DROUGHT
EXTRATROPICAL_CYCLONE
FIRE_WEATHER
FLASH_FLOOD
FLOOD
FOG
FREEZING
FREEZING_AIR_TEMPERATURE
FREEZING_DRIZZLE
FREEZING_RAIN
FROST
GALE
GLAZE
HAIL
HAZARDOUS_SEAS
HEAT
HUMIDITY
HURRICANE
ICE_STORM
LAKE_EFFECT_SNOW
MONSOON
MUDDY_FLOOD
OUTFLOW
RAIN 		RIVER_FLOODING
SEVERE_THUNDERSTORM_WARNING
SNOW
SNOWSQUALL
STORM
STORM_SURGE
THUNDER
THUNDERSTORM
TORNADO
TORNADO_WARNING
TROPICAL_CYCLONE
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES
TROPICAL_DISTURBANCE
TROPICAL_STORM
TYPHOON
WIND
WIND_CHILL
WIND_WAVE
WINTER_STORM
WILDFIRE
BUSHFIRE
FIRE
LANDSLIDE
EARTHQUAKE
DUST_STORM
AFTERSHOCK
TSUNAMI
VOLCANIC_ASH
VOLCANIC_ERUPTION
RADIATION

Działanie tłumaczenia odpowiedzi

Google udostępnia tłumaczenia tylko w przypadku pola alertTitle. Inne pola, takie jak eventType, areaName, instruction i safetyRecommendations, również mogą być tłumaczone w zależności od obsługi języków przez pierwotne źródło danych. Google nie może jednak udostępniać niezależnych tłumaczeń tych pól.

Na podstawie parametru languageCode uwzględnionego w żądaniu oczekuje się, że pole alertTitle będzie się zachowywać w ten sposób:

  • Obsługiwany languageCode: jeśli żądany languageCode jest podany i obsługiwany, odpowiedź jest zwracana w wybranym języku.
  • Nieobsługiwane languageCode: jeśli żądany język languageCode nie jest obsługiwany i nie można znaleźć zbliżonej alternatywy, punkt końcowy domyślnie zwraca odpowiedź w języku angielskim.
  • Brak parametru languageCode: punkt końcowy domyślnie zwraca odpowiedź w języku angielskim.

Przykład żądania alertu pogodowego

Ten przykład żądania dotyczy informacji o alercie pogodowym dla miasta w Karolinie Północnej:

curl -X GET "https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=35.824635&location.longitude=-78.3168047&languageCode=en"

Treść odpowiedzi wygląda tak:

{
  "weatherAlerts": [
    {
      "alertId": "urn:oid:2.49.0.1.840.0.2416b1b5a6f51d29ef4b94948328dca303fbbb5c.001.1",
      "alertTitle": {
        "text": "Flash Flood Warning",
        "languageCode": "en"
      },
      "eventType": "FLASH_FLOOD",
      "areaName": "Franklin, NC; Johnston, NC; Nash, NC; Wake, NC",
      "polygon": "{\"type\":\"Polygon\",\"coordinates\":[[[-78.450000,35.820000],[-78.410000,35.730000],[-78.280000,35.660000],
        [-78.180000,35.740000],[-77.840000,36.150000],[-77.890000,36.140000],[-77.900000,36.160000],[-77.920000,36.170000],
        [-77.930000,36.190000], [-77.940000,36.190000],[-77.950000,36.180000],[-77.970000,36.190000],[-77.970000,36.180000],
        [-77.980000,36.180000],[-78.010000,36.210000],[-78.040000,36.210000],[-78.110000,36.210000],[-78.130000,36.230000],
        [-78.350000,35.940000],[-78.450000,35.820000]]]}",
      "description": "FFWRAH\n\nThe National Weather Service in Raleigh has issued a\n\n* Flash Flood Warning for...
        \nEastern Franklin County in central North Carolina...\nNorth Central Johnston County in central North Carolina...
        \nWestern Nash County in central North Carolina...\nEast Central Wake County in central North Carolina...
        \n\n* Until 530 PM EDT.\n\n* At 224 PM EDT, local law enforcement reported flash flooding in\nSpring Hope. Between 3 and 5 inches of rain have fallen.
        \nAdditional rainfall amounts of 1 to 3 inches are possible in the\nwarned area.\n\nHAZARD...Life threatening flash flooding.
        Heavy rain producing\nflash flooding.\n\nSOURCE...Law enforcement reported.\n\nIMPACT...Life threatening flash flooding of creeks and streams,\nurban areas,
        highways, streets and underpasses.\n\n* Some locations that will experience flash flooding include...
        \nZebulon, Bunn, Wendell, Spring Hope, Middlesex, Castalia,\nCenterville, Pilot, Emit and Aventon.",
      "severity": "SEVERE",
      "certainty": "LIKELY",
      "urgency": "IMMEDIATE",
      "instruction": [
        "Turn around, don't drown when encountering flooded roads. Most flood\ndeaths occur in vehicles."
      ],
      "safetyRecommendations": [
        {
          "directive": "Build an emergency kit and make a family communications plan.",
          "subtext": "Follow the instructions at http://www.ready.gov/build-a-kit for building 
            an emergency kit and http://www.ready.gov/make-a-plan for a family communications plan."
        },
        {
          "directive": "Be aware that flash flooding can occur. ",
          "subtext": "If there is any possibility of a flash flood, move immediately to higher ground. Do not wait for instructions to move."
        },
        ...
      ],
      "timezoneOffset": "-14400s",
      "startTime": "2025-08-06T18:24:00Z",
      "expirationTime": "2025-08-06T21:30:00Z",
      "dataSource": {
        "publisher": "NOAA",
        "name": "National Weather Service",
        "authorityUri": "https://www.weather.gov/"
      }
    }
  ],
  "regionCode": "US"
}

Wypróbuj

Narzędzie APIs Explorer umożliwia wysyłanie przykładowych żądań, dzięki czemu możesz zapoznać się z interfejsem API i jego opcjami.

  1. Po prawej stronie strony kliknij ikonę interfejsu API api.

  2. Opcjonalnie edytuj parametry żądania.

  3. Kliknij przycisk Wykonaj. W oknie wybierz konto, którego chcesz użyć do wysłania prośby.

  4. W panelu APIs Explorer kliknij ikonę pełnego ekranu , aby rozwinąć okno APIs Explorer.