Otrzymywanie alertów pogodowych

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

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

• Opady: deszcz, śnieg, grad, susze i inne.
• ekstremalne temperatury – zimno, upał, mróz, przymrozek, odczuwalna temperatura i wilgotność;
• Wiatr i burze: zamiecie śnieżne, huragany, tornada, burze tropikalne, burze z piorunami i inne.
• Ograniczona widoczność: mgła, burze piaskowe i zamiecie śnieżne.
• Zagrożenia związane z wodą: powodzie, tsunami, fale sztormowe, zagrożenia na wybrzeżu 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 sekcji Typy zdarzeń pogodowych.

Alerty mogą zawierać zlokalizowane opisy, 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 postaci nieprzetworzonej. Więcej informacji o źródłach alertów pogodowych znajdziesz w sekcji Źródła danych.

Interfejs API zwraca te informacje o danym alercie pogodowym:

• Typ zdarzenia pogodowego powiązanego z alertem.
• lista obszarów, których dotyczy problem, wraz ze współrzędnymi określającymi ich granice geograficzne;
• Podsumowanie zdarzenia pogodowego w 1 zdaniu.
• Poziomy ważności, pewności i pilności
• Opis instrukcji dotyczących zalecanych działań dla docelowych odbiorców
• Zalecenia dotyczące bezpieczeństwa
• czas rozpoczęcia i zakończenia alertu,
• nazwę i witrynę organu wydają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

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

Informacje o odpowiedziach na alerty pogodowe

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

Ź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 szerokości i długości geograficznej podanych w żądaniu treść odpowiedzi zawiera dane z odpowiednich lokalnych władz.

Dostawcy uwzględnieni w kanale przestrzegają wytycznych Google dotyczących alertów publicznych. Google może w każdej chwili zaktualizować listę dostawców.

Atrybucja

Na wszystkich wyświetlaczach, na których prezentowane są dane, aplikacja klienta musi zawierać atrybucję do oryginalnego ź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 adresem URL podanym w polu authorityUri (np. „National Weather Service”).

Typy zdarzeń pogodowych

Obsługiwane są te typy zdarzeń pogodowych:

Działanie tłumaczenia odpowiedzi

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

W zależności od parametru languageCode zawartego w żądaniu oczekiwane są następujące zachowania pola alertTitle:

• Obsługiwany languageCode: jeśli żądany languageCode jest zarówno dostępny, jak i obsługiwany, odpowiedź jest zwracana w żądanym języku.
• Nieobsługiwany languageCode: w przypadkach, gdy żądany languageCode nie jest obsługiwany i nie można znaleźć zbliżonej alternatywy, punkt końcowy domyślnie zwraca odpowiedź w języku angielskim.
• Nie podano parametru languageCode: punkt końcowy domyślnie zwraca odpowiedź w języku angielskim.

Przykład prośby o alert pogodowy

W tym przykładzie żądanie dotyczy informacji o ostrzeżeniach pogodowych 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 jest taka:

{
  "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 kliknij ikonę interfejsu API api.

2. Opcjonalnie możesz edytować 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 fullscreen, aby rozwinąć okno APIs Explorer.