Method: publicAlerts.lookup

Zwraca publiczne alerty pogodowe dla danej lokalizacji.

Żądanie HTTP

GET https://weather.googleapis.com/v1/publicAlerts:lookup

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
location

object (LatLng)

Wymagane. Lokalizacja, dla której chcesz otrzymywać publiczne alerty pogodowe. Usługa zwróci alerty, których obszar objęty wpływem zdarzenia przecina się z tą lokalizacją.
pageSize

integer

Opcjonalnie: Maksymalna liczba rekordów publicznych alertów pogodowych do zwrócenia na stronie.
pageToken

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania publicAlerts.lookup. Podaj ten token, aby pobrać kolejną stronę. Podczas paginacji wszystkie inne parametry przekazane do funkcji publicAlerts.lookup muszą być zgodne z wywołaniem, które dostarczyło token strony.
languageCode

string

Opcjonalnie: Umożliwia klientowi wybór języka odpowiedzi. Jeśli dane nie mogą zostać podane w danym języku, interfejs API używa najbliższego dopasowania. Dozwolone wartości są zgodne ze standardem IETF BCP-47. Wartość domyślna to „en”.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na wywołanie RPC publicAlerts.lookup.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "weatherAlerts": [
    {
      object (PublicAlerts)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
Pola
weatherAlerts[]

object (PublicAlerts)

Publiczne rekordy alertów pogodowych, zgodnie z liczbą alertów i rozmiarem strony określonymi w żądaniu.
regionCode

string

Kod ISO_3166-1 alfa-2 regionu odpowiadającego lokalizacji podanej w żądaniu. Region jest podany w formacie ISO_3166-1_alpha-2.
nextPageToken

string

Token, który można wysłać jako pageToken, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/cloud-platform

PublicAlerts

Reprezentuje publiczne alerty pogodowe.

Zapis JSON 
{
  "alertId": string,
  "alertTitle": {
    object (LocalizedText)
  },
  "eventType": enum (WeatherEventType),
  "areaName": string,
  "instruction": [
    string
  ],
  "safetyRecommendations": [
    {
      object (SafetyRecommendation)
    }
  ],
  "timezoneOffset": string,
  "startTime": string,
  "expirationTime": string,
  "dataSource": {
    object (DataSource)
  },
  "polygon": string,
  "description": string,
  "severity": enum (Severity),
  "certainty": enum (Certainty),
  "urgency": enum (Urgency)
}
Pola
alertId

string

Unikalny identyfikator tego alertu.
alertTitle

object (LocalizedText)

Zlokalizowany tytuł alertu.
eventType

enum (WeatherEventType)

Rodzaj zjawiska pogodowego.
areaName

string

Nazwa obszaru, w którym wydano alert.
instruction[]

string

Instrukcje zalecane przez wydawcę. Pamiętaj, że to pole powinno być zlokalizowane, ale nie ma takiej gwarancji.
safetyRecommendations[]

object (SafetyRecommendation)

Wytyczne dotyczące bezpieczeństwa dla użytkownika, które mogą być dostarczane przez wydawcę lub inne organy.
timezoneOffset

string

Przesunięcie strefy czasowej od czasu UTC dla lokalizacji alertu. Wartość jest sformatowana jako ciąg znaków kończący się literą „s”, np. „-14400s” w przypadku 4 godzin przed UTC.
startTime

string (Timestamp format)

Godzina rozpoczęcia wydarzenia.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
expirationTime

string (Timestamp format)

Czas wygaśnięcia wydarzenia.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
dataSource

object (DataSource)

Szczegóły wydawcy, który wydał alert.
polygon

string

Reprezentacja GeoJSON obszarów, w których wydawany jest alert.

Dane GeoJSON muszą być w formacie RFC 7946 i reprezentować wielokąt (w przypadku jednego spójnego obszaru) lub wielokąt (w przypadku wielu odrębnych obszarów).

Przykład:

{ "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] }

Przykładowy ciąg GeoJSON typu MultiPolygon wygląda tak:

{ "type": "MultiPolygon", "coordinates": [ [ [0, 0], [-1, 0], [-1, 1], [0, 0] ], [ [0, 0], [-2, 0], [-2, 2], [0, 0] ] ]
description

string

Najnowszy tekst opisujący alert wydany przez oficjalny organ. Pamiętaj, że to pole powinno być zlokalizowane, ale nie ma takiej gwarancji.
severity

enum (Severity)

Poziom ważności alertu.
certainty

enum (Certainty)

Pewność alertu.
urgency

enum (Urgency)

pilność alertu,

WeatherEventType

Rodzaj zdarzenia pogodowego.

Wartości w polu enum
WEATHER_EVENT_TYPE_UNSPECIFIED Nieokreślony typ zdarzenia pogodowego.
ACID_RAIN Kwaśny deszcz.
AFTERSHOCK Wstrząs wtórny.
AVALANCHE Wydarzenie związane z lawiną.
BLIZZARD Zamieć.
BLOWING_SNOW Zawieja śnieżna.
BUSHFIRE Zdarzenie związane z pożarem buszu.
COASTAL_FLOOD Powódź nadbrzeżna.
COASTAL_HAZARD Zagrożenie przybrzeżne.
COLD Zdarzenie zimne.
CYCLONE Cyklon.
DROUGHT Zdarzenie związane z suszą.
DUST_STORM Burza pyłowa.
EARTHQUAKE Zdarzenie dotyczące trzęsienia ziemi.
EXTRATROPICAL_CYCLONE Ekstratropikalny cyklon.
FIRE Zdarzenie Fire.
FIRE_WEATHER Zdarzenie związane z warunkami sprzyjającymi pożarom.
FLASH_FLOOD Powódź błyskawiczna.
FLOOD Powódź.
FOG Zdarzenie dotyczące mgły.
FREEZING Zawieszenie.
FREEZING_AIR_TEMPERATURE Zdarzenie związane z temperaturą powietrza poniżej zera.
FREEZING_DRIZZLE Marznąca mżawka.
FREEZING_RAIN_EVENT Opady marznącego deszczu.
FROST Zdarzenie związane z mrozem.
GALE Zdarzenie Gale.
GLAZE Zdarzenie dotyczące polewy.
HAIL Gradobicie.
HAZARDOUS_SEAS Niebezpieczne warunki na pełnym morzu.
HEAT Ekstremalne upały.
HUMIDITY Zdarzenie związane z wilgotnością.
HURRICANE Huragan.
ICE_STORM Burza lodowa.
INDUSTRIAL_FIRE Pożar zakładów przemysłowych.
LAKE_EFFECT_SNOW Efekt jeziora.
LANDSLIDE Zdarzenie dotyczące osuwiska.
MONSOON Wydarzenie Monsoon.
MUDDY_FLOOD Powódź błotna.
OUTFLOW Zdarzenie wypływu.
RADIATION Zdarzenie związane z promieniowaniem.
RAIN_EVENT Opady deszczu.
RIVER_FLOODING Powódź rzeczna.
SEVERE_THUNDERSTORM_WARNING Ostrzeżenie przed silną burzą z piorunami.
SNOWSQUALL Snowsquall event.
SNOW_EVENT Wydarzenie związane ze śniegiem.
STORM Burza.
STORM_SURGE Fala sztormowa.
THUNDER Zdarzenie dotyczące burzy.
THUNDERSTORM Burza z wyładowaniami atmosferycznymi.
TORNADO Tornado.
TORNADO_WARNING zdarzenie ostrzegawcze przed tornadem;
TROPICAL_CYCLONE Cyklon tropikalny.
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES Ostrzeżenia i alerty dotyczące cyklonów tropikalnych.
TROPICAL_DISTURBANCE Zdarzenie związane z zaburzeniami tropikalnymi.
TROPICAL_STORM Burza tropikalna.
TSUNAMI Wydarzenie związane z tsunami.
TYPHOON Zdarzenie związane z tajfunem.
VOLCANIC_ASH Wydarzenie związane z pyłem wulkanicznym.
VOLCANIC_ERUPTION Erupcja wulkanu.
WILDFIRE Zdarzenie związane z pożarem lasu.
WIND Zdarzenie związane z wiatrem.
WIND_CHILL Zdarzenie związane z temperaturą odczuwalną.
WIND_WAVE Wydarzenie związane z falami wiatrowymi.
WINTER_STORM Śnieżyca.

Poziom ważności

Kod oznaczający poziom ważności zdarzenia, którego dotyczy alert.

Wartości w polu enum
SEVERITY_UNKNOWN Poziom ważności nieznany.
EXTREME Nadzwyczajne zagrożenie życia lub mienia.
SEVERE Znaczne zagrożenie życia lub mienia.
MODERATE Możliwe zagrożenie życia lub mienia.
MINOR Niewielkie zagrożenie życia lub mienia.

Pewność

Kod określający pewność wystąpienia zdarzenia, którego dotyczy alert.

Wartości w polu enum
CERTAINTY_UNKNOWN Nieznana pewność.
OBSERVED stwierdzono, że wystąpiło lub trwa.
VERY_LIKELY Bardzo prawdopodobne.
LIKELY Prawdopodobne (p > ~50%).
POSSIBLE Możliwe, ale mało prawdopodobne (p <= ~50%).
UNLIKELY Mało prawdopodobne (p ~ 0%).

Pilność

Kod oznaczający pilność zdarzenia będącego tematem alertu.

Wartości w polu enum
URGENCY_UNKNOWN Nieznany poziom pilności.
IMMEDIATE Należy natychmiast podjąć odpowiednie działania.
EXPECTED Należy wkrótce podjąć odpowiednie działania (w ciągu najbliższej godziny).
FUTURE W najbliższej przyszłości NALEŻY podjąć odpowiednie działania.
PAST Nie jest już wymagane podjęcie działań w odpowiedzi na alert.

SafetyRecommendation

Reprezentuje zalecenie dotyczące bezpieczeństwa.

Zapis JSON 
{
  "directive": string,
  "subtext": string
}
Pola
directive

string

instrukcja dla użytkownika. Pamiętaj, że to pole powinno być zlokalizowane, ale nie ma takiej gwarancji.
subtext

string

Opcjonalny podtytuł dyrektywy, który może zawierać dodatkowy kontekst dla użytkownika. Pamiętaj, że to pole powinno być zlokalizowane, ale nie ma takiej gwarancji.

DataSource

Reprezentuje link do źródła danych.

Zapis JSON 
{
  "publisher": enum (Publisher),
  "name": string,
  "authorityUri": string
}
Pola
publisher

enum (Publisher)

Wydawca alertu.
name

string

Oficjalna nazwa wydawcy. Pamiętaj, że to pole powinno być zlokalizowane, ale nie ma takiej gwarancji.
authorityUri

string

Adres URL witryny urzędu.

Wydawca

Wydawca alertu.

Wartości w polu enum
PUBLISHER_UNSPECIFIED Wydawca nieokreślony.
AUSTRALIA_ACT_ESA Australia, Australijskie Terytorium Stołeczne
AUSTRALIA_NSW_RFS Nowa Południowa Walia
AUSTRALIA_QLD_QFES Queensland
AUSTRALIA_SA_CFS Australia Południowa
METEO_ALARM_AT Meteoalarm / EUMETNET Austria
METEO_ALARM_BS Bośnia
BRAZIL_CENAD Brazylijska agencja ds. reagowania na katastrofy w Brazylii
BRAZIL_INMET Agencja meteorologiczna w Brazylii
UK_ENV_AGENCY Wielka Brytania
METEO_ALARM_BG Meteoalarm / EUMETNET Bulgaria
METEO_ALARM_CR Chorwacja
METEO_ALARM_CY Cypr
METEO_ALARM_CS Czechy
METEO_ALARM_DK Dania
EC_INAMHI Ekwador
METEO_ALARM_FI Meteoalarm / EUMETNET Finland
METEO_ALARM_FR Francja
DE_DWD Niemcy
METEO_ALARM_GB Meteoalarm / EUMETNET Wielka Brytania
METEO_ALARM_GR Grecja
METEO_ALARM_HU Węgry
METEO_ALARM_IS Islandia
METEO_ALARM_IE Irlandia
METEO_ALARM_IT Włochy
JM_JMS Jamajka
JMA Japonia
METEO_ALARM_NL Meteoalarm / EUMETNET Netherlands
METEO_ALARM_LV Łotwa
METEO_ALARM_LT Litwa
METEO_ALARM_LU Luksemburg
MEXICO_CIRES Meksyk Meksyk CIRES
NZ_GEONET Nowa Zelandia, GeoNet
NZ_NMS MetService
METEO_ALARM_MK Meteoalarm / EUMETNET Macedonia Północna
METEO_ALARM_NO Norwegia
PHILIPPINES_PAGASA Filipiny
METEO_ALARM_PL Meteoalarm / EUMETNET Poland
METEO_ALARM_PT Portugalia
METEO_ALARM_RO Rumunia
METEO_ALARM_RS Serbia
SG_MSS Singapur
METEO_ALARM_SK Meteoalarm / EUMETNET Slovakia
METEO_ALARM_SI Słowenia
SB_MET Wyspy Salomona
METEO_ALARM_ES Meteoalarm / EUMETNET Spain
METEO_ALARM_SE Szwecja
METEO_ALARM_CH Szwajcaria
TAIWAN_NCDR Tajwan
NOAA United States NOAA
WCATWC National Tsunami Warning Center