Package google.maps.weather.v1

Indeks

Pogoda

Definicja usługi interfejsu Weather API.

LookupCurrentConditions

rpc LookupCurrentConditions(LookupCurrentConditionsRequest) returns (LookupCurrentConditionsResponse)

Zwraca aktualne warunki pogodowe w danej lokalizacji.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc LookupForecastDays(LookupForecastDaysRequest) returns (LookupForecastDaysResponse)

Zwraca prognozy dzienne na maksymalnie 10 dni w danym miejscu, począwszy od bieżącego dnia.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc LookupForecastHours(LookupForecastHoursRequest) returns (LookupForecastHoursResponse)

Zwraca prognozy godzinowe dla danej lokalizacji z wyprzedzeniem do 240 godzin, począwszy od bieżącej godziny.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc LookupHistoryHours(LookupHistoryHoursRequest) returns (LookupHistoryHoursResponse)

Zwraca dane historyczne dotyczące pogody w podziale na godziny z ostatnich 24 godzin w danym miejscu, zaczynając od ostatniej godziny.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc LookupPublicAlerts(LookupPublicAlertsRequest) returns (LookupPublicAlertsResponse)

Zwraca publiczne alerty pogodowe dla danej lokalizacji.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

AirPressure

Reprezentuje warunki ciśnienia atmosferycznego.

Pola
mean_sea_level_millibars

float

Ciśnienie powietrza na poziomie morza w milibarach.

CardinalDirection

Reprezentuje kierunek główny (w tym kierunki pośrednie).

Wartości w polu enum
CARDINAL_DIRECTION_UNSPECIFIED Kierunek kardynalny nie jest określony.
NORTH Kierunek północny.
NORTH_NORTHEAST Kierunek pośredni północno-północno-wschodni.
NORTHEAST Kierunek pośredni północno-wschodni.
EAST_NORTHEAST Kierunek pośredni wschód-północny wschód.
EAST Kierunek wschodni.
EAST_SOUTHEAST Kierunek wschód-południowy wschód.
SOUTHEAST Kierunek pośredni południowo-wschodni.
SOUTH_SOUTHEAST Południowo-południowo-wschodni kierunek pośredni.
SOUTH Kierunek południowy.
SOUTH_SOUTHWEST Południowo-południowo-zachodni kierunek pośredni.
SOUTHWEST Kierunek pośredni południowo-zachodni.
WEST_SOUTHWEST Kierunek pośredni drugorzędny zachód-południowy zachód.
WEST Zachód.
WEST_NORTHWEST Kierunek pośredni zachód-północny zachód.
NORTHWEST Kierunek pośredni północno-zachodni.
NORTH_NORTHWEST Kierunek pośredni północno-północno-zachodni.

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%).

DataSource

Reprezentuje link do źródła danych.

Pola
publisher

Publisher

Wydawca alertu.

name

string

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

authority_uri

string

Adres URL witryny urzędu.

ForecastDay

Reprezentuje rekord prognozy dziennej w danej lokalizacji.

Pola
interval

Interval

Przedział czasu UTC, w którym rozpoczyna się (włącznie) i kończy (wyłącznie) prognozowany dzień. Uwaga: dzień zaczyna się o 7:00 i kończy o 7:00 następnego dnia czasu lokalnego. Jeśli na przykład lokalna strefa czasowa to UTC-7, przedział czasu rozpocznie się o godzinie 14:00:00.000Z i zakończy o tej samej godzinie następnego dnia.

display_date

Date

Lokalna data w strefie czasowej lokalizacji (czas cywilny), dla której obliczana jest prognoza dzienna. To pole może być używane do wyświetlania informacji na urządzeniu klienta.

daytime_forecast

ForecastDayPart

Prognozowane warunki pogodowe w ciągu dnia (od 7:00 do 19:00 czasu lokalnego).

nighttime_forecast

ForecastDayPart

Prognozowane warunki pogodowe w nocy (od 19:00 do 7:00 następnego dnia czasu lokalnego).

max_temperature

Temperature

Maksymalna temperatura w ciągu dnia.

min_temperature

Temperature

Minimalna (najniższa) temperatura w ciągu dnia.

feels_like_max_temperature

Temperature

Maksymalna (wysoka) temperatura odczuwalna w ciągu dnia.

feels_like_min_temperature

Temperature

Minimalna (najniższa) temperatura odczuwalna w ciągu dnia.

max_heat_index

Temperature

Maksymalna temperatura odczuwalna w ciągu dnia.

sun_events

SunEvents

Zdarzenia związane ze słońcem (np. wschód i zachód słońca).

moon_events

MoonEvents

Wydarzenia związane z księżycem (np. wschód i zachód księżyca).

ForecastDayPart

Reprezentuje rekord prognozy dla części dnia.

Pola
interval

Interval

Data i godzina w czasie UTC, kiedy rozpoczyna się (włącznie) i kończy (wyłącznie) ta część dnia. Uwaga: część dnia rozpoczyna się o 7:00 i kończy o 19:00 tego samego dnia czasu lokalnego. Przykład: jeśli lokalna strefa czasowa to UTC-7, przedział czasu w ciągu dnia rozpocznie się o godzinie 14:00:00.000Z i zakończy o godzinie 02:00:00.000Z następnego dnia, a przedział czasu w nocy rozpocznie się o godzinie 02:00:00.000Z następnego dnia i zakończy o godzinie 14:00:00.000Z tego samego dnia.

weather_condition

WeatherCondition

Prognozowane warunki pogodowe.

precipitation

Precipitation

Prognozowane opady.

wind

Wind

średni kierunek wiatru oraz maksymalna prędkość i porywy wiatru;

ice_thickness

IceThickness

Łączna ilość lodu w danym okresie dnia.

relative_humidity

int32

Prognozowany procent wilgotności względnej (wartości od 0 do 100).

uv_index

int32

Maksymalny prognozowany indeks ultrafioletowy (UV).

thunderstorm_probability

int32

Średnie prawdopodobieństwo wystąpienia burzy z piorunami.

cloud_cover

int32

Średni procent zachmurzenia.

ForecastHour

Reprezentuje rekord prognozy godzinowej w danej lokalizacji.

Pola
interval

Interval

Jednogodzinny przedział (w czasie UTC), w którym te dane prognozy są ważne (sygnatury czasowe są zaokrąglane w dół do najbliższej godziny).

display_date_time

DateTime

Lokalna data i godzina w strefie czasowej lokalizacji (czas cywilny), dla której obliczana jest prognoza godzinowa. To pole może być używane do wyświetlania informacji na urządzeniu klienta. Uwaga: ta data będzie zawierać rok, miesiąc, dzień, godzinę i przesunięcie względem czasu UTC.

weather_condition

WeatherCondition

Prognozowane warunki pogodowe.

temperature

Temperature

prognozowana temperatura,

feels_like_temperature

Temperature

Informacja o tym, jaka będzie odczuwalna temperatura w wybranej lokalizacji.

dew_point

Temperature

Prognozowana temperatura punktu rosy.

heat_index

Temperature

prognozowana temperatura odczuwalna,

wind_chill

Temperature

Prognozowana temperatura odczuwalna, czyli temperatura powietrza odczuwana na skórze.

wet_bulb_temperature

Temperature

Prognozowana temperatura mokrego termometru, czyli najniższa temperatura, jaką można osiągnąć przez odparowanie wody.

precipitation

Precipitation

Prognozowane prawdopodobieństwo wystąpienia opadów i ich ilość w ciągu ostatniej godziny.

air_pressure

AirPressure

Prognozowane warunki ciśnienia powietrza.

wind

Wind

Prognozowane warunki wiatrowe.

visibility

Visibility

Prognozowana widoczność.

ice_thickness

IceThickness

Prognozowana grubość lodu.

is_daytime

bool

Wartość „prawda”, jeśli ta godzina przypada między lokalnym wschodem słońca (włącznie) a zachodem słońca (wyłącznie). W przeciwnym razie jest noc (między zachodem słońca a następnym wschodem). Uwaga: ta godzina będzie traktowana jako dzienna lub nocna, jeśli przedział czasu pokrywa się odpowiednio z lokalnymi godzinami wschodu i zachodu słońca (np. jeśli przedział czasu to 5:00–6:00, a wschód słońca następuje o 5:59, wartość is_daytime będzie wynosić „true”).

relative_humidity

int32

Prognozowany procent wilgotności względnej (wartości od 0 do 100).

uv_index

int32

Prognozowany indeks UV.

thunderstorm_probability

int32

Prognozowane prawdopodobieństwo wystąpienia burzy (wartości od 0 do 100).

cloud_cover

int32

Prognozowany odsetek nieba pokrytego chmurami (wartości od 0 do 100).

HistoryHour

Reprezentuje rekord historii godzinowej w danej lokalizacji.

Pola
interval

Interval

Jednogodzinny przedział (w czasie UTC), w którym te dane historyczne są ważne (sygnatury czasowe są zaokrąglane w dół do najbliższej godziny).

display_date_time

DateTime

Lokalna data i godzina w strefie czasowej lokalizacji (czas cywilny), dla której obliczono ten godzinowy rekord. To pole może być używane do wyświetlania informacji na urządzeniu klienta. Uwaga: ta data będzie zawierać rok, miesiąc, dzień, godzinę i przesunięcie względem czasu UTC.

weather_condition

WeatherCondition

historyczne warunki pogodowe;

temperature

Temperature

historyczna temperatura,

feels_like_temperature

Temperature

Miara tego, jak odczuwalna jest temperatura w wybranej lokalizacji.

dew_point

Temperature

historyczna temperatura punktu rosy,

heat_index

Temperature

historyczna temperatura wskaźnika ciepła,

wind_chill

Temperature

Historyczna temperatura odczuwalna, czyli temperatura powietrza odczuwana na skórze.

wet_bulb_temperature

Temperature

Historyczna temperatura mokrego termometru, czyli najniższa temperatura, jaką można osiągnąć przez odparowanie wody.

precipitation

Precipitation

Prawdopodobieństwo wystąpienia opadów w przeszłości i ilość opadów w ciągu ostatniej godziny.

air_pressure

AirPressure

Historyczne warunki ciśnienia atmosferycznego.

wind

Wind

historyczne warunki wiatrowe;

visibility

Visibility

Widoczność historyczna.

ice_thickness

IceThickness

historyczna grubość lodu;

is_daytime

bool

Wartość „prawda”, jeśli ta godzina przypada między lokalnym wschodem słońca (włącznie) a zachodem słońca (wyłącznie). W przeciwnym razie jest noc (między zachodem słońca a następnym wschodem). Uwaga: ta godzina będzie traktowana jako dzienna lub nocna, jeśli przedział czasu pokrywa się odpowiednio z lokalnymi godzinami wschodu i zachodu słońca (np. jeśli przedział czasu to 5:00–6:00, a wschód słońca następuje o 5:59, wartość is_daytime będzie wynosić „true”).

relative_humidity

int32

Historyczny procent wilgotności względnej (wartości od 0 do 100).

uv_index

int32

Historyczny indeks UV.

thunderstorm_probability

int32

Historyczne prawdopodobieństwo wystąpienia burzy (wartości od 0 do 100).

cloud_cover

int32

Historyczny odsetek nieba pokrytego chmurami (wartości od 0 do 100).

IceThickness

Reprezentuje warunki grubości lodu.

Pola
unit

Unit

Kod reprezentujący jednostkę używaną do pomiaru grubości lodu.

thickness

float

Wartość grubości lodu.

Jednostka

Określa jednostkę używaną do pomiaru grubości lodu.

Wartości w polu enum
UNIT_UNSPECIFIED Nie określono jednostki.
MILLIMETERS Grubość jest mierzona w milimetrach.
INCHES Grubość jest mierzona w calach.

LookupCurrentConditionsRequest

Żądanie wywołania RPC LookupCurrentConditions.

Pola
location

LatLng

Wymagane. Lokalizacja, dla której chcesz uzyskać aktualne warunki pogodowe.

units_system

UnitsSystem

Opcjonalnie: System jednostek, który ma być używany w przypadku zwracanych warunków pogodowych. Jeśli nie podasz tego parametru, zwrócone warunki pogodowe będą podane w systemie metrycznym (domyślnie = METRIC).

language_code

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”.

LookupCurrentConditionsResponse

Odpowiedź na wywołanie procedury LookupCurrentConditions RPC – zawiera informacje o aktualnych warunkach pogodowych w wybranej lokalizacji.

Pola
current_time

Timestamp

Aktualny czas (UTC) powiązany ze zwróconymi danymi.

time_zone

TimeZone

Strefa czasowa w żądanej lokalizacji.

weather_condition

WeatherCondition

Aktualne warunki pogodowe.

temperature

Temperature

bieżąca temperatura,

feels_like_temperature

Temperature

Miara tego, jak temperatura jest obecnie odczuwana w wybranej lokalizacji.

dew_point

Temperature

bieżąca temperatura punktu rosy,

heat_index

Temperature

bieżąca temperatura odczuwalna,

wind_chill

Temperature

Aktualna temperatura odczuwalna, czyli temperatura powietrza odczuwana na skórze.

precipitation

Precipitation

Aktualne prawdopodobieństwo opadów i ilość opadów z ostatniej godziny.

air_pressure

AirPressure

Aktualne warunki ciśnienia powietrza.

wind

Wind

bieżące warunki wiatrowe,

visibility

Visibility

bieżąca widoczność,

current_conditions_history

CurrentConditionsHistory

Zmiany w obecnych warunkach w ciągu ostatnich 24 godzin.

is_daytime

bool

Wartość „true”, jeśli bieżąca godzina w żądanej lokalizacji przypada między lokalnym wschodem słońca (włącznie) a zachodem słońca (wyłącznie). W przeciwnym razie jest noc (między zachodem słońca a następnym wschodem).

relative_humidity

int32

Obecny procent wilgotności względnej (wartości od 0 do 100).

uv_index

int32

Obecny indeks promieniowania ultrafioletowego (UV).

thunderstorm_probability

int32

Aktualne prawdopodobieństwo wystąpienia burzy (wartości od 0 do 100).

cloud_cover

int32

Obecny procent pokrycia nieba przez chmury (wartości od 0 do 100).

CurrentConditionsHistory

Reprezentuje zestaw zmian w bieżących warunkach w ciągu ostatnich 24 godzin.

Pola
temperature_change

Temperature

bieżąca temperatura minus temperatura sprzed 24 godzin,

max_temperature

Temperature

Najwyższa temperatura w ciągu ostatnich 24 godzin.

min_temperature

Temperature

Minimalna (najniższa) temperatura w ciągu ostatnich 24 godzin.

snow_qpf

QuantitativePrecipitationForecast

Ilość śniegu, mierzona jako ekwiwalent wody w stanie ciekłym, która spadła w ciągu ostatnich 24 godzin. Uwaga: QPF to skrót od Quantitative Precipitation Forecast (więcej informacji znajdziesz w definicji QuantitativePrecipitationForecast).

qpf

QuantitativePrecipitationForecast

Ilość opadów deszczu mierzona jako ekwiwalent wody w stanie ciekłym, która zgromadziła się w ciągu ostatnich 24 godzin. Uwaga: QPF to skrót od Quantitative Precipitation Forecast (więcej informacji znajdziesz w definicji QuantitativePrecipitationForecast).

LookupForecastDaysRequest

Żądanie RPC LookupForecastDays.

Pola
location

LatLng

Wymagane. Lokalizacja, dla której ma być wyświetlana prognoza dzienna.

units_system

UnitsSystem

Opcjonalnie: System jednostek, który ma być używany w przypadku zwracanych warunków pogodowych. Jeśli nie podasz tego parametru, zwrócone warunki pogodowe będą podane w systemie metrycznym (domyślnie = METRIC).

page_size

int32

Opcjonalnie: Maksymalna liczba rekordów prognozy dziennej do zwrócenia na stronie – wartość od 1 do 10 (włącznie). Wartością domyślną jest 5.

page_token

string

Opcjonalnie: Token strony otrzymany z poprzedniego żądania. Służy do pobierania następnej strony.

days

int32

Opcjonalnie: Ogranicza liczbę dni do pobrania, począwszy od bieżącego dnia – wartość od 1 do 10 (włącznie). Wartość domyślna to maksymalna dozwolona wartość 10.

language_code

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”.

LookupForecastDaysResponse

Odpowiedź na RPC LookupForecastDays.

Pola
forecast_days[]

ForecastDay

Rekordy prognozy dziennej, zgodnie z liczbą dni i rozmiarem strony określonymi w żądaniu.

time_zone

TimeZone

Strefa czasowa w żądanej lokalizacji.

next_page_token

string

Token do pobrania następnej strony.

LookupForecastHoursRequest

Prośba o wywołanie procedury RPC LookupForecastHours.

Pola
location

LatLng

Wymagane. Lokalizacja, dla której chcesz uzyskać prognozę godzinową.

units_system

UnitsSystem

Opcjonalnie: System jednostek, który ma być używany w przypadku zwracanych warunków pogodowych. Jeśli nie podasz tego parametru, zwrócone warunki pogodowe będą podane w systemie metrycznym (domyślnie = METRIC).

page_size

int32

Opcjonalnie: Maksymalna liczba rekordów prognozy godzinowej do zwrócenia na stronie – wartość z zakresu od 1 do 24 (włącznie). Wartością domyślną jest maksymalna dozwolona wartość 24.

page_token

string

Opcjonalnie: Token strony otrzymany z poprzedniego żądania. Służy do pobierania następnej strony.

hours

int32

Opcjonalnie: Ogranicza liczbę godzin do pobrania, począwszy od bieżącej godziny – wartość z zakresu od 1 do 240 (włącznie). Domyślna wartość to maksymalna dozwolona wartość 240.

language_code

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”.

LookupForecastHoursResponse

Odpowiedź na wywołanie RPC LookupForecastHours.

Pola
forecast_hours[]

ForecastHour

Prognozy godzinowe są rejestrowane zgodnie z liczbą godzin i rozmiarem strony określonymi w żądaniu.

time_zone

TimeZone

Strefa czasowa w żądanej lokalizacji.

next_page_token

string

Token do pobrania następnej strony.

LookupHistoryHoursRequest

Żądanie wywołania procedury RPC LookupHistoryHours.

Pola
location

LatLng

Wymagane. Lokalizacja, dla której chcesz uzyskać godzinowe dane historyczne.

units_system

UnitsSystem

Opcjonalnie: System jednostek, który ma być używany w przypadku zwracanych warunków pogodowych. Jeśli nie podasz tego parametru, zwrócone warunki pogodowe będą podane w systemie metrycznym (domyślnie = METRIC).

page_size

int32

Opcjonalnie: Maksymalna liczba historycznych rekordów godzinowych do zwrócenia na stronie – wartość od 1 do 24 (włącznie). Wartością domyślną jest maksymalna dozwolona wartość 24.

page_token

string

Opcjonalnie: Token strony otrzymany z poprzedniego żądania. Służy do pobierania następnej strony.

hours

int32

Opcjonalnie: Ogranicza liczbę godzin do pobrania, zaczynając od ostatniej godziny – od 1 do 24 (włącznie). Wartością domyślną jest maksymalna dozwolona wartość 24.

language_code

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”.

LookupHistoryHoursResponse

Odpowiedź na wywołanie RPC LookupHistoryHours.

Pola
history_hours[]

HistoryHour

Godzinowe rekordy historyczne zgodnie z liczbą godzin i rozmiarem strony określonymi w żądaniu.

time_zone

TimeZone

Strefa czasowa w żądanej lokalizacji.

next_page_token

string

Token do pobrania następnej strony.

LookupPublicAlertsRequest

Prośba o wywołanie RPC LookupPublicAlerts.

Pola
location

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ą.

page_size

int32

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

page_token

string

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

language_code

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”.

LookupPublicAlertsResponse

Odpowiedź na wywołanie RPC LookupPublicAlerts.

Pola
weather_alerts[]

PublicAlerts

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

region_code

string

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

next_page_token

string

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

MoonEvents

Reprezentuje wydarzenia związane z księżycem (np. wschód i zachód księżyca).

Pola
moonrise_times[]

Timestamp

Czas, w którym górna krawędź Księżyca pojawia się nad horyzontem (patrz https://en.wikipedia.org/wiki/Moonrise_and_moonset)).

UWAGA: w większości przypadków w ciągu dnia występuje tylko 1 wschód Księżyca. W innych przypadkach lista może być pusta (np. gdy księżyc wschodzi po północy następnego dnia). W wyjątkowych przypadkach (np. w regionach polarnych) lista może zawierać więcej niż 1 wartość. W takich przypadkach wartości są sortowane w kolejności rosnącej.

moonset_times[]

Timestamp

Moment, w którym górna krawędź Księżyca znika poniżej horyzontu (patrz https://en.wikipedia.org/wiki/Moonrise_and_moonset)).

UWAGA: w większości przypadków każdego dnia będzie tylko 1 godzina zachodu Księżyca. W innych przypadkach lista może być pusta (np. gdy księżyc zachodzi po północy następnego dnia). W wyjątkowych przypadkach (np. w regionach polarnych) lista może zawierać więcej niż 1 wartość. W takich przypadkach wartości są sortowane w kolejności rosnącej.

moon_phase

MoonPhase

Faza księżyca.

MoonPhase

Oznacza fazę księżyca.

Wartości w polu enum
MOON_PHASE_UNSPECIFIED Nieokreślona faza księżyca.
NEW_MOON Księżyc nie jest oświetlony przez Słońce.
WAXING_CRESCENT Księżyc jest oświetlony w 0–50% po prawej stronie na półkuli północnej 🌒 i po lewej stronie na półkuli południowej 🌘.
FIRST_QUARTER Księżyc jest oświetlony w 50,1% po prawej stronie na półkuli północnej 🌓 i po lewej stronie na półkuli południowej 🌗.
WAXING_GIBBOUS Księżyc jest oświetlony w 50–100% po prawej stronie na półkuli północnej 🌔 i po lewej stronie na półkuli południowej 🌖.
FULL_MOON Księżyc jest w pełni oświetlony.
WANING_GIBBOUS W przypadku półkuli północnej Księżyc jest oświetlony w 50–100% po lewej stronie 🌖, a w przypadku półkuli południowej – po prawej stronie 🌔.
LAST_QUARTER Księżyc jest oświetlony w 50,1% po lewej stronie na półkuli północnej 🌗 i po prawej stronie na półkuli południowej 🌓.
WANING_CRESCENT W przypadku półkuli północnej oświetlona jest lewa strona Księżyca (0–50%) 🌘, a w przypadku półkuli południowej – prawa strona (0–50%) 🌒.

Opady

Reprezentuje zbiór wartości opadów w danej lokalizacji.

Pola
probability

PrecipitationProbability

Prawdopodobieństwo opadów (wartości od 0 do 100).

snow_qpf

QuantitativePrecipitationForecast

Ilość śniegu mierzona jako ekwiwalent wody w stanie ciekłym, która zgromadziła się w danym okresie. Uwaga: QPF to skrót od Quantitative Precipitation Forecast (więcej informacji znajdziesz w definicji QuantitativePrecipitationForecast).

qpf

QuantitativePrecipitationForecast

Ilość opadów deszczu, mierzona jako ekwiwalent wody w stanie ciekłym, która zgromadziła się w danym okresie. Uwaga: QPF to skrót od Quantitative Precipitation Forecast (więcej informacji znajdziesz w definicji QuantitativePrecipitationForecast).

PrecipitationProbability

Określa prawdopodobieństwo opadów w danej lokalizacji.

Pola
type

PrecipitationType

Kod wskazujący rodzaj opadów.

percent

int32

Wartość procentowa od 0 do 100, która wskazuje prawdopodobieństwo opadów.

PrecipitationType

Określa rodzaj opadów w danej lokalizacji.

Wartości w polu enum
PRECIPITATION_TYPE_UNSPECIFIED Nieokreślony typ opadów.
NONE Brak opadów.
SNOW Opady śniegu.
RAIN Opady deszczu.
LIGHT_RAIN Niewielkie opady deszczu.
HEAVY_RAIN Intensywne opady deszczu.
RAIN_AND_SNOW Opady deszczu i śniegu.
SLEET Opady deszczu ze śniegiem.
FREEZING_RAIN Opady marznącego deszczu.

PublicAlerts

Reprezentuje publiczne alerty pogodowe.

Pola
alert_id

string

Unikalny identyfikator tego alertu.

alert_title

LocalizedText

Zlokalizowany tytuł alertu.

event_type

WeatherEventType

Rodzaj zjawiska pogodowego.

area_name

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.

safety_recommendations[]

SafetyRecommendation

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

timezone_offset

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.

start_time

Timestamp

Godzina rozpoczęcia wydarzenia.

expiration_time

Timestamp

Czas wygaśnięcia wydarzenia.

data_source

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

Severity

Poziom ważności alertu.

certainty

Certainty

Pewność alertu.

urgency

Urgency

pilność alertu,

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

QuantitativePrecipitationForecast

Oznacza oczekiwaną ilość stopionych opadów zgromadzonych w określonym czasie na określonym obszarze (źródło: https://en.wikipedia.org/wiki/Quantitative_precipitation_forecast). Zwykle w skrócie QPF.

Pola
unit

Unit

Kod jednostki używanej do pomiaru ilości skumulowanych opadów.

quantity

float

Ilość opadów mierzona jako ekwiwalent wody w stanie ciekłym, która zgromadziła się w określonym czasie.

Jednostka

Określa jednostkę używaną do pomiaru ilości zgromadzonych opadów.

Wartości w polu enum
UNIT_UNSPECIFIED Nieokreślona jednostka opadów.
MILLIMETERS Wielkość opadów jest mierzona w milimetrach.
INCHES Wielkość opadów jest mierzona w calach.

SafetyRecommendation

Reprezentuje zalecenie dotyczące bezpieczeństwa.

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.

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.

SpeedUnit

Reprezentuje jednostkę używaną do pomiaru prędkości.

Wartości w polu enum
SPEED_UNIT_UNSPECIFIED Jednostka prędkości nie jest określona.
KILOMETERS_PER_HOUR Prędkość jest mierzona w kilometrach na godzinę.
MILES_PER_HOUR Prędkość jest mierzona w milach na godzinę.

SunEvents

Reprezentuje zdarzenia związane ze słońcem (np. wschód i zachód słońca).

Pola
sunrise_time

Timestamp

Godzina wschodu słońca.

UWAGA: w niektórych wyjątkowych przypadkach (np. na północ od koła podbiegunowego) w danym dniu może nie być wschodu słońca. W takich przypadkach to pole zostanie wyczyszczone.

sunset_time

Timestamp

Godzina zachodu słońca.

UWAGA: w niektórych wyjątkowych przypadkach (np. na północ od koła podbiegunowego) może nie być czasu zachodu słońca w danym dniu. W takich przypadkach to pole zostanie wyczyszczone.

Temperatura

Reprezentuje wartość temperatury.

Pola
unit

TemperatureUnit

Kod jednostki używanej do pomiaru wartości temperatury.

degrees

float

Wartość temperatury (w stopniach) w określonej jednostce.

TemperatureUnit

Reprezentuje jednostkę używaną do pomiaru temperatury.

Wartości w polu enum
TEMPERATURE_UNIT_UNSPECIFIED Jednostka temperatury jest nieokreślona.
CELSIUS Temperatura jest mierzona w stopniach Celsjusza.
FAHRENHEIT Temperatura jest mierzona w stopniach Fahrenheita.

UnitsSystem

Reprezentuje system jednostek używany do pomiaru wartości.

Wartości w polu enum
UNITS_SYSTEM_UNSPECIFIED System jednostek jest nieokreślony.
IMPERIAL system jednostek imperialnych (np. stopnie Fahrenheita, mile itp.);
METRIC System jednostek metrycznych (np.stopnie Celsjusza, kilometry itp.).

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.

Widoczność

Określa warunki widoczności, czyli odległość, z jakiej można rozpoznać obiekty.

Pola
unit

Unit

Kod reprezentujący jednostkę używaną do pomiaru odległości.

distance

float

Odległość widoczności w określonej jednostce.

Jednostka

Określa jednostkę używaną do pomiaru odległości widoczności.

Wartości w polu enum
UNIT_UNSPECIFIED Jednostka widoczności jest nieokreślona.
KILOMETERS Widoczność jest mierzona w kilometrach.
MILES Widoczność jest mierzona w milach.

WeatherCondition

Reprezentuje warunki pogodowe w danej lokalizacji w określonym czasie.

Wyłączenie odpowiedzialności: ikony pogody i kody warunków mogą ulec zmianie. W razie potrzeby Google może wprowadzać nowe kody i ikony lub aktualizować dotychczasowe. Zachęcamy do regularnego sprawdzania tej dokumentacji, aby mieć dostęp do najbardziej aktualnych informacji.

Pola
icon_base_uri

string

Podstawowy identyfikator URI ikony bez rozszerzenia typu pliku. Aby wyświetlić ikonę, dołącz do tego identyfikatora URI motyw (jeśli chcesz) i rozszerzenie typu pliku (.png lub .svg). Domyślnie ikona ma jasny motyw, ale w przypadku trybu ciemnego można dodać parametr _dark. Na przykład: „https://maps.gstatic.com/weather/v1/dust.svg” lub „https://maps.gstatic.com/weather/v1/dust_dark.svg”, gdzie icon_base_uri to „https://maps.gstatic.com/weather/v1/dust”.

description

LocalizedText

Tekstowy opis warunków pogodowych (w odpowiednim języku).

type

Type

Rodzaj warunków pogodowych.

Typ

Określa typ warunków pogodowych w kontekście elementu prognozy.

Wartości w polu enum
TYPE_UNSPECIFIED Warunki pogodowe są nieokreślone.
CLEAR Brak chmur.
MOSTLY_CLEAR Okresowe zachmurzenia.
PARTLY_CLOUDY Częściowe zachmurzenie (niektóre chmury).
MOSTLY_CLOUDY Przewaga chmur (więcej chmur niż słońca).
CLOUDY Pochmurno (wszystkie chmury, bez słońca).
WINDY Silny wiatr.
WIND_AND_RAIN Silny wiatr z opadami.
LIGHT_RAIN_SHOWERS Przelotne, niewielkie opady deszczu.
CHANCE_OF_SHOWERS Możliwe przelotne opady deszczu.
SCATTERED_SHOWERS Przelotne opady deszczu.
RAIN_SHOWERS Przelotne opady deszczu trwają krócej niż deszcz i charakteryzują się nagłym początkiem i końcem oraz szybką zmianą intensywności.
HEAVY_RAIN_SHOWERS Intensywne opady.
LIGHT_TO_MODERATE_RAIN Opady deszczu (lekkie do umiarkowanych).
MODERATE_TO_HEAVY_RAIN Opady deszczu (umiarkowane do silnych).
RAIN Umiarkowane opady deszczu.
LIGHT_RAIN Niewielkie opady deszczu.
HEAVY_RAIN Intensywne opady deszczu.
RAIN_PERIODICALLY_HEAVY Opady deszczu, okresowo intensywne.
LIGHT_SNOW_SHOWERS Lekki śnieg, który pada z różną intensywnością przez krótkie okresy.
CHANCE_OF_SNOW_SHOWERS Możliwe przelotne opady śniegu.
SCATTERED_SNOW_SHOWERS Opady śniegu o różnym natężeniu, które trwają przez krótki czas.
SNOW_SHOWERS Przelotne opady śniegu.
HEAVY_SNOW_SHOWERS Intensywne przelotne opady śniegu.
LIGHT_TO_MODERATE_SNOW Opady śniegu lekkie do umiarkowanych.
MODERATE_TO_HEAVY_SNOW Opady śniegu umiarkowane do silnych.
SNOW Umiarkowane opady śniegu.
LIGHT_SNOW Lekkie opady śniegu.
HEAVY_SNOW Intensywne opady śniegu.
SNOWSTORM Opady śniegu z możliwymi burzami z piorunami.
SNOW_PERIODICALLY_HEAVY Opady śniegu, okresowo intensywne.
HEAVY_SNOW_STORM Intensywne opady śniegu z możliwymi grzmotami i błyskawicami.
BLOWING_SNOW Opady śniegu z silnym wiatrem.
RAIN_AND_SNOW Deszcz ze śniegiem.
HAIL Grad.
HAIL_SHOWERS Grad, który pada z różną intensywnością przez krótki czas.
THUNDERSTORM Burza z piorunami.
THUNDERSHOWER Ulewa z towarzyszącymi jej grzmotami i błyskawicami.
LIGHT_THUNDERSTORM_RAIN Lekka burza z deszczem.
SCATTERED_THUNDERSTORMS Burze z piorunami, podczas których przez krótki czas występują opady deszczu o różnym natężeniu.
HEAVY_THUNDERSTORM Gwałtowna burza z piorunami.

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.

Wiatr

Reprezentuje zestaw właściwości wiatru.

Pola
direction

WindDirection

Kierunek wiatru, czyli kąt, pod jakim wieje.

speed

WindSpeed

Prędkość wiatru.

gust

WindSpeed

poryw wiatru (nagły wzrost prędkości wiatru);

WindDirection

Określa kierunek, z którego wieje wiatr.

Pola
cardinal

CardinalDirection

Kod reprezentujący kierunek główny, z którego wieje wiatr.

degrees

int32

Kierunek wiatru w stopniach (wartości od 0 do 360).

WindSpeed

Prędkość wiatru.

Pola
unit

SpeedUnit

Kod reprezentujący jednostkę używaną do pomiaru prędkości wiatru.

value

float

Wartość prędkości wiatru.