Punkt końcowy
publicAlerts
zawiera szczegółowe informacje o alertach dotyczących konkretnych zjawisk pogodowych wydawanych przez
autorytatywne agencje krajowe i międzynarodowe. Alerty te 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 to:
- Opady: deszcz, śnieg, grad, susze i inne
- Ekstremalne temperatury: zimno, upał, mróz, przymrozek, temperatura odczuwalna i wilgotność
- Wichury i burze: zamiecie śnieżne, huragany, tornada, burze tropikalne, burze z wyładowaniami atmosferycznymi i inne.
- Ograniczenia widoczności: mgła, burze pyłowe i zamiecie śnieżne.
- Zagrożenia związane z wodą: powodzie, tsunami, fale sztormowe, zagrożenia nadbrzeżne i inne.
- Wydarzenia 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 postaci (surowe treści). 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:
- Rodzaj zdarzenia pogodowego powiązanego z alertem.
- Lista obszarów dotkniętych problemem wraz ze współrzędnymi określającymi granice geograficzne tych obszarów.
- Jednozdaniowe podsumowanie zjawiska pogodowego
- Poziomy ważności, pewności i pilności
- Opis instrukcji dotyczących działań zalecanych grupie docelowej
- Zalecenia dotyczące bezpieczeństwa
- czas rozpoczęcia i zakończenia alertu;
- Nazwa i strona internetowa 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 HTTP GET 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 uwzględnij współrzędne geograficzne 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 tekstowy, który jest tłumaczony, gdy w żądaniu znajduje się parametr kodu języka. |
Wymagane |
eventType |
Typ wyliczeniowy | Rodzaj zdarzenia pogodowego powiązanego z alertem. Pełną listę obsługiwanych zdarzeń pogodowych znajdziesz w artykule Typy zdarzeń 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 przestrzenny alertu. | Opcjonalny |
description |
Ciąg znaków | Krótkie zdanie podsumowujące opis zdarzenia w określonym języku (np. „Ostrzeżenie przed tornadem”). | Opcjonalny |
severity |
Typ wyliczeniowy | Poziom ważności alertu:
|
Opcjonalny |
certainty |
Typ wyliczeniowy | Poziom pewności alertu:
|
Opcjonalny |
urgency |
Typ wyliczeniowy | Poziom pilności alertu:
|
Opcjonalny |
instruction |
Ciąg znaków | Opis instrukcji dotyczących elastycznych reklam z wezwaniem do działania dla grupy docelowej. | Opcjonalny |
safetyRecommendations |
Ciąg znaków | Zalecenia dotyczące bezpieczeństwa oparte na kodach instytucji 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), od których obowiązują informacje w alercie. | Opcjonalny |
expirationTime |
DateTime | Data i godzina (czas UTC), kiedy alert ma się zakończyć. W przypadku wydarzeń trwających w nieskończoność może mieć wartość null. W takim przypadku nagłówek będzie wskazywać, że wydarzenie „obowiązuje”. | Opcjonalny |
dataSource |
Typ wyliczeniowy | Szczegóły dotyczące organu, w tym wydawca, nazwa i adres URL. | Wymagane |
regionCode |
Typ wyliczeniowy | Kod regionu lokalizacji, o którą wysłano prośbę. | Opcjonalny |
Źródła danych
Punkt końcowy alertów pogodowych zwraca dane opublikowane przez dostawców wymienionych w tej tabeli. 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 Google dotyczących alertów publicznych. Google może w każdej chwili zaktualizować listę dostawców.
Atrybucja
Na wszystkich ekranach, na których wyświetlane 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_RAINAVALANCHEBLIZZARDBLOWING_SNOWCOASTAL_FLOODCOASTAL_HAZARDCOLDCYCLONEDROUGHTEXTRATROPICAL_CYCLONEFIRE_WEATHERFLASH_FLOODFLOODFOGFREEZINGFREEZING_AIR_TEMPERATUREFREEZING_DRIZZLEFREEZING_RAINFROSTGALEGLAZEHAILHAZARDOUS_SEASHEATHUMIDITYHURRICANEICE_STORMLAKE_EFFECT_SNOWMONSOONMUDDY_FLOODOUTFLOWRAIN
|
RIVER_FLOODINGSEVERE_THUNDERSTORM_WARNINGSNOWSNOWSQUALLSTORMSTORM_SURGETHUNDERTHUNDERSTORMTORNADOTORNADO_WARNINGTROPICAL_CYCLONETROPICAL_CYCLONE_WARNINGS_AND_WATCHESTROPICAL_DISTURBANCETROPICAL_STORMTYPHOONWINDWIND_CHILLWIND_WAVEWINTER_STORMWILDFIREBUSHFIREFIRELANDSLIDEEARTHQUAKEDUST_STORMAFTERSHOCKTSUNAMIVOLCANIC_ASHVOLCANIC_ERUPTIONRADIATION |
Działanie tłumaczenia odpowiedzi
Google zapewnia 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.
W zależności od parametru languageCode zawartego w żądaniu oczekuje się, że pole alertTitle będzie się zachowywać w ten sposób:
- Obsługiwany
languageCode: jeśli żądanylanguageCodejest dostępny i obsługiwany, odpowiedź jest zwracana w żądanym języku. - Nieobsługiwane
languageCode: w przypadku, gdy żądany języklanguageCodenie jest obsługiwany i nie można znaleźć bliskiej 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
W tym przykładzie wysyłamy żądanie 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 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.
Po prawej stronie strony kliknij ikonę interfejsu API api.
Opcjonalnie możesz edytować parametry żądania.
Kliknij przycisk Wykonaj. W oknie dialogowym wybierz konto, z którego chcesz wysłać prośbę.
W panelu APIs Explorer kliknij ikonę pełnego ekranu fullscreen, aby rozwinąć okno narzędzia.