Package google.maps.weather.v1

Индекс

Погода

Определение сервиса для API погоды.

Поиск текущих условий

rpc LookupCurrentConditions( LookupCurrentConditionsRequest ) returns ( LookupCurrentConditionsResponse )

Возвращает текущие погодные условия в заданном месте.

Области авторизации

Требуется следующая область OAuth:

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

rpc LookupForecastDays( LookupForecastDaysRequest ) returns ( LookupForecastDaysResponse )

Возвращает до 10 дней ежедневных прогнозов погоды в указанном месте, начиная с текущего дня.

Области авторизации

Требуется следующая область OAuth:

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

rpc LookupForecastHours( LookupForecastHoursRequest ) returns ( LookupForecastHoursResponse )

Возвращает до 240 часов почасовых прогнозов в указанном месте, начиная с текущего часа.

Области авторизации

Требуется следующая область OAuth:

  • https://www.googleapis.com/auth/cloud-platform
Часы поискаИстории

rpc LookupHistoryHours( LookupHistoryHoursRequest ) returns ( LookupHistoryHoursResponse )

Возвращает до 24 часов почасовых исторических данных о погоде в указанном месте, начиная с последнего часа.

Области авторизации

Требуется следующая область OAuth:

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

rpc LookupPublicAlerts( LookupPublicAlertsRequest ) returns ( LookupPublicAlertsResponse )

Возвращает оповещения о погоде для указанного местоположения.

Области авторизации

Требуется следующая область OAuth:

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

Давление воздуха

Представляет условия атмосферного давления воздуха.

Поля
mean_sea_level_millibars

float

Среднее давление воздуха на уровне моря в миллибарах.

CardinalDirection

Представляет основное направление (включая порядковые направления).

Перечисления
CARDINAL_DIRECTION_UNSPECIFIED Направление сторон света не определено.
NORTH Северное направление света.
NORTH_NORTHEAST Вторичное интеркардинальное направление северо-северо-восток.
NORTHEAST Северо-восточное интеркардинальное направление.
EAST_NORTHEAST Вторичное интеркардинальное направление восток-северо-восток.
EAST Восточная сторона света.
EAST_SOUTHEAST Вторичное интеркардинальное направление восток-юго-восток.
SOUTHEAST Юго-восточное интеркардинальное направление.
SOUTH_SOUTHEAST Юго-юго-восточное вторичное интеркардинальное направление.
SOUTH Южное кардинальное направление.
SOUTH_SOUTHWEST Вторичное интеркардинальное направление юг-юго-запад.
SOUTHWEST Юго-западное интеркардинальное направление.
WEST_SOUTHWEST Вторичное интеркардинальное направление запад-юго-запад.
WEST Западное направление света.
WEST_NORTHWEST Вторичное интеркардинальное направление запад-северо-запад.
NORTHWEST Северо-западное интеркардинальное направление.
NORTH_NORTHWEST Вторичное интеркардинальное направление северо-северо-запад.

Уверенность

Код, обозначающий достоверность события, о котором распространяется оповещение.

Перечисления
CERTAINTY_UNKNOWN Точность неизвестна.
OBSERVED Установлено, что событие произошло или продолжается.
VERY_LIKELY Очень вероятно.
LIKELY Вероятно (p > ~50%).
POSSIBLE Возможно, но маловероятно (p <= ~50%).
UNLIKELY Маловероятно (p ~ 0%).

Источник данных

Представляет ссылку на источник данных.

Поля
publisher

Publisher

Издатель оповещения.

name

string

Официальное название издателя. Обратите внимание: хотя это поле и должно быть локализовано, это не гарантируется.

authority_uri

string

URL-адрес веб-сайта органа власти.

ПрогнозДня

Представляет собой ежедневную запись прогноза погоды в заданном месте.

Поля
interval

Interval

Интервал времени UTC, в течение которого прогнозируемый день начинается (включительно) и заканчивается (не включая). Примечание: день начинается в 7:00 и заканчивается в 7:00 следующего дня по местному времени. Например: если местный часовой пояс — UTC-7, то интервал начнётся в 14:00:00.000Z и закончится в тот же час следующего дня.

display_date

Date

Местная дата в часовом поясе местоположения (гражданское время), для которого рассчитывается данный ежедневный прогноз. Это поле может использоваться для отображения в клиентской программе.

daytime_forecast

ForecastDayPart

Прогнозируемые погодные условия на дневное время суток (с 7:00 до 19:00 по местному времени).

nighttime_forecast

ForecastDayPart

Прогнозируемые погодные условия на ночную часть суток (с 19:00 до 7:00 следующего дня по местному времени).

max_temperature

Temperature

Максимальная (высокая) температура в течение дня.

min_temperature

Temperature

Минимальная (низкая) температура в течение дня.

feels_like_max_temperature

Temperature

Максимальная (высокая) ощущаемая температура в течение дня.

feels_like_min_temperature

Temperature

Минимальная (низкая) ощущаемая температура в течение дня.

max_heat_index

Temperature

Максимальная температура индекса тепла в течение дня.

sun_events

SunEvents

События, связанные с солнцем (например, восход, закат).

moon_events

MoonEvents

События, связанные с луной (например, восход луны, заход луны).

ПрогнозЧастиДня

Представляет собой прогнозируемую запись на часть дня.

Поля
interval

Interval

Дата и время UTC начала (включительно) и окончания (не включая) этой части суток. Примечание: часть суток начинается в 7:00 и заканчивается в 19:00 того же дня по местному времени. Например, если местный часовой пояс — UTC-7, то дневной интервал начнётся в 14:00:00.000Z и закончится в 02:00:00.000Z следующего дня, а ночной интервал начнётся в 02:00:00.000Z следующего дня и закончится в 14:00:00.000Z того же дня.

weather_condition

WeatherCondition

Прогнозируемые погодные условия.

precipitation

Precipitation

Прогнозируемое количество осадков.

wind

Wind

Среднее направление ветра, максимальная скорость и порыв.

ice_thickness

IceThickness

Накопленное количество льда за часть дня.

relative_humidity

int32

Прогнозируемый процент относительной влажности (значения от 0 до 100).

uv_index

int32

Максимальный прогнозируемый ультрафиолетовый (УФ) индекс.

thunderstorm_probability

int32

Средняя вероятность грозы.

cloud_cover

int32

Средний процент облачности.

ПрогнозЧас

Представляет собой почасовую запись прогноза погоды в заданном месте.

Поля
interval

Interval

Данные прогноза действительны в течение часового интервала (по времени UTC) (временные метки округляются до ближайшего часа).

display_date_time

DateTime

Локальная дата и время в часовом поясе местоположения (гражданское время), для которого рассчитывается данный почасовой прогноз. Это поле может использоваться для отображения в клиенте. Примечание: эта дата будет состоять из года, месяца, дня, часа и смещения относительно UTC.

weather_condition

WeatherCondition

Прогнозируемые погодные условия.

temperature

Temperature

Прогнозируемая температура.

feels_like_temperature

Temperature

Мера того, как будет ощущаться температура в указанном месте.

dew_point

Temperature

Прогнозируемая температура точки росы.

heat_index

Temperature

Прогнозируемая температура индекса тепла.

wind_chill

Temperature

Прогнозируемое ветро-охлаждение, температура воздуха, воздействующая на кожу.

wet_bulb_temperature

Temperature

Прогнозируемая температура по влажному термометру — самая низкая температура, достижимая при испарении воды.

precipitation

Precipitation

Прогнозируемая вероятность осадков и количество осадков, накопленных за последний час.

air_pressure

AirPressure

Прогнозируемые условия давления воздуха.

wind

Wind

Прогнозируемые ветровые условия.

visibility

Visibility

Прогнозируемая видимость.

ice_thickness

IceThickness

Прогнозируемая толщина льда.

is_daytime

bool

True, если этот час находится между местным временем восхода (включительно) и временем заката (исключая). В противном случае это ночь (между заходом и следующим восходом). Примечание: этот час будет считаться днём или ночью, если интервал пересекается с местным временем восхода и захода соответственно (например, если интервал длится с 5:00 до 6:00, а восход солнца происходит в 5:59, то is_daytime будет true).

relative_humidity

int32

Прогнозируемый процент относительной влажности (значения от 0 до 100).

uv_index

int32

Прогнозируемый ультрафиолетовый (УФ) индекс.

thunderstorm_probability

int32

Прогнозируемая вероятность грозы (значения от 0 до 100).

cloud_cover

int32

Прогнозируемый процент неба, покрытого облаками (значения от 0 до 100).

HistoryHour

Представляет собой почасовую запись истории в указанном месте.

Поля
interval

Interval

Эти исторические данные действительны в течение часового интервала (по времени UTC) (временные метки округляются до ближайшего часа).

display_date_time

DateTime

Локальная дата и время в часовом поясе местоположения (гражданское время), для которого рассчитывается эта почасовая запись. Это поле может использоваться для отображения в клиенте. Примечание: эта дата будет состоять из года, месяца, дня, часа и смещения относительно UTC.

weather_condition

WeatherCondition

Исторические погодные условия.

temperature

Temperature

Историческая температура.

feels_like_temperature

Temperature

Показатель ощутимой температуры в указанном месте.

dew_point

Temperature

Историческая температура точки росы.

heat_index

Temperature

Исторический индекс температуры тепла.

wind_chill

Temperature

Историческое воздействие ветра на кожу, температура воздуха.

wet_bulb_temperature

Temperature

Историческая температура влажного термометра — самая низкая температура, достижимая при испарении воды.

precipitation

Precipitation

Историческая вероятность осадков и количество осадков, накопленных за последний час.

air_pressure

AirPressure

Исторические условия давления воздуха.

wind

Wind

Исторические ветровые условия.

visibility

Visibility

Историческая видимость.

ice_thickness

IceThickness

Историческая толщина льда.

is_daytime

bool

True, если этот час находится между местным временем восхода (включительно) и временем заката (исключая). В противном случае это ночь (между заходом и следующим восходом). Примечание: этот час будет считаться днём или ночью, если интервал пересекается с местным временем восхода и захода соответственно (например, если интервал длится с 5:00 до 6:00, а восход солнца происходит в 5:59, то is_daytime будет true).

relative_humidity

int32

Исторический процент относительной влажности (значения от 0 до 100).

uv_index

int32

Исторический ультрафиолетовый (УФ) индекс.

thunderstorm_probability

int32

Историческая вероятность грозы (значения от 0 до 100).

cloud_cover

int32

Исторический процент неба, покрытого облаками (значения от 0 до 100).

Толщина льда

Отражает условия толщины льда.

Поля
unit

Unit

Код, представляющий единицу измерения толщины льда.

thickness

float

Значение толщины льда.

Единица

Представляет собой единицу измерения толщины льда.

Перечисления
UNIT_UNSPECIFIED Единица измерения не указана.
MILLIMETERS Толщина измеряется в миллиметрах.
INCHES Толщина измеряется в дюймах.

ПоискТекущиеУсловияЗапрос

Запрос на LookupCurrentConditions RPC.

Поля
location

LatLng

Обязательно. Местоположение, для которого необходимо получить текущие погодные условия.

units_system

UnitsSystem

Необязательно. Система единиц измерения, используемая для возвращаемых погодных условий. Если не указано, возвращаемые погодные условия будут представлены в метрической системе (по умолчанию = МЕТРИЧЕСКАЯ).

language_code

string

Необязательно. Позволяет клиенту выбрать язык ответа. Если данные для этого языка не могут быть предоставлены, API использует наиболее близкое соответствие. Допустимые значения основаны на стандарте IETF BCP-47. Значение по умолчанию — «en».

ПоискТекущиеУсловияОтвет

Ответ на RPC LookupCurrentConditions — представляет текущие погодные условия в запрошенном месте.

Поля
current_time

Timestamp

Текущее время (UTC), связанное с возвращенными данными.

time_zone

TimeZone

Часовой пояс в запрашиваемом месте.

weather_condition

WeatherCondition

Текущие погодные условия.

temperature

Temperature

Текущая температура.

feels_like_temperature

Temperature

Показатель того, как ощущается температура в указанном месте в данный момент.

dew_point

Temperature

Текущая температура точки росы.

heat_index

Temperature

Текущая температура теплового индекса.

wind_chill

Temperature

Текущий уровень холода от ветра, температура воздуха, воздействующая на кожу.

precipitation

Precipitation

Текущая вероятность осадков и количество осадков, накопленных за последний час.

air_pressure

AirPressure

Текущие условия давления воздуха.

wind

Wind

Текущие ветровые условия.

visibility

Visibility

Текущая видимость.

current_conditions_history

CurrentConditionsHistory

Изменения текущих условий за последние 24 часа.

is_daytime

bool

Истина, если текущее время в указанном месте находится между местным временем восхода солнца (включительно) и временем захода солнца (исключительно). В противном случае — ночь (между временем захода солнца и следующим восходом солнца).

relative_humidity

int32

Текущий процент относительной влажности (значения от 0 до 100).

uv_index

int32

Текущий ультрафиолетовый (УФ) индекс.

thunderstorm_probability

int32

Текущая вероятность грозы (значения от 0 до 100).

cloud_cover

int32

Текущий процент неба, закрытый облаками (значения от 0 до 100).

ТекущиеСостоянияИстория

Представляет собой набор изменений текущих условий за последние 24 часа.

Поля
temperature_change

Temperature

Текущая температура минус температура 24 часа назад.

max_temperature

Temperature

Максимальная (высокая) температура за последние 24 часа.

min_temperature

Temperature

Минимальная (низкая) температура за последние 24 часа.

snow_qpf

QuantitativePrecipitationForecast

Количество снега, измеренное в эквиваленте жидкой воды, выпавшего за последние 24 часа. Примечание: QPF — это сокращение от Quantitative Precipitation Forecast (количественный прогноз осадков) (подробнее см. в определении QuantitativePrecipitationForecast).

qpf

QuantitativePrecipitationForecast

Количество осадков, измеренное в жидком водном эквиваленте, накопленное за последние 24 часа. Примечание: QPF — это сокращение от Quantitative Precipitation Forecast (количественный прогноз осадков) (подробнее см. в определении QuantitativePrecipitationForecast).

LookupForecastDaysRequest

Запрос на LookupForecastDays RPC.

Поля
location

LatLng

Обязательно. Местоположение, для которого необходимо получить ежедневный прогноз.

units_system

UnitsSystem

Необязательно. Система единиц измерения, используемая для возвращаемых погодных условий. Если не указано, возвращаемые погодные условия будут представлены в метрической системе (по умолчанию = МЕТРИЧЕСКАЯ).

page_size

int32

Необязательно. Максимальное количество записей суточного прогноза, возвращаемых на странице — от 1 до 10 (включительно). Значение по умолчанию — 5.

page_token

string

Необязательный. Токен страницы, полученный из предыдущего запроса. Используется для получения следующей страницы.

days

int32

Необязательно. Ограничивает количество дней для выборки, начиная с текущего дня, — значение от 1 до 10 (включительно). Значение по умолчанию — максимально допустимое значение 10.

language_code

string

Необязательно. Позволяет клиенту выбрать язык ответа. Если данные для этого языка не могут быть предоставлены, API использует наиболее близкое соответствие. Допустимые значения основаны на стандарте IETF BCP-47. Значение по умолчанию — «en».

LookupForecastDaysResponse

Ответ на RPC LookupForecastDays.

Поля
forecast_days[]

ForecastDay

Ежедневные записи прогноза погоды производятся в соответствии с количеством дней и размером страницы, указанными в запросе.

time_zone

TimeZone

Часовой пояс в запрашиваемом месте.

next_page_token

string

Токен для получения следующей страницы.

ПоискПрогнозЧасыЗапрос

Запрос на LookupForecastHours RPC.

Поля
location

LatLng

Обязательно. Местоположение, для которого необходимо получить почасовой прогноз.

units_system

UnitsSystem

Необязательно. Система единиц измерения, используемая для возвращаемых погодных условий. Если не указано, возвращаемые погодные условия будут представлены в метрической системе (по умолчанию = МЕТРИЧЕСКАЯ).

page_size

int32

Необязательно. Максимальное количество записей почасового прогноза, возвращаемых на странице — от 1 до 24 (включительно). Значение по умолчанию — максимально допустимое 24.

page_token

string

Необязательный. Токен страницы, полученный из предыдущего запроса. Используется для получения следующей страницы.

hours

int32

Необязательно. Ограничивает количество часов для извлечения, начиная с текущего часа, — значение от 1 до 240 (включительно). Значение по умолчанию — максимально допустимое значение 240.

language_code

string

Необязательно. Позволяет клиенту выбрать язык ответа. Если данные для этого языка не могут быть предоставлены, API использует наиболее близкое соответствие. Допустимые значения основаны на стандарте IETF BCP-47. Значение по умолчанию — «en».

ПоискПрогнозЧасыОтвет

Ответ на RPC LookupForecastHours.

Поля
forecast_hours[]

ForecastHour

Почасовой прогноз записывается в соответствии с количеством часов и размером страницы, указанными в запросе.

time_zone

TimeZone

Часовой пояс в запрашиваемом месте.

next_page_token

string

Токен для получения следующей страницы.

ПоискИсторияЧасыЗапрос

Запрос на LookupHistoryHours RPC.

Поля
location

LatLng

Обязательно. Местоположение, для которого необходимо получить почасовые исторические данные.

units_system

UnitsSystem

Необязательно. Система единиц измерения, используемая для возвращаемых погодных условий. Если не указано, возвращаемые погодные условия будут представлены в метрической системе (по умолчанию = МЕТРИЧЕСКАЯ).

page_size

int32

Необязательно. Максимальное количество почасовых исторических записей, возвращаемых на странице — от 1 до 24 (включительно). Значение по умолчанию — максимально допустимое значение 24.

page_token

string

Необязательный. Токен страницы, полученный из предыдущего запроса. Используется для получения следующей страницы.

hours

int32

Необязательно. Ограничивает общее количество часов для извлечения, начиная с последнего часа: от 1 до 24 (включительно). Значение по умолчанию — максимально допустимое значение 24.

language_code

string

Необязательно. Позволяет клиенту выбрать язык ответа. Если данные для этого языка не могут быть предоставлены, API использует наиболее близкое соответствие. Допустимые значения основаны на стандарте IETF BCP-47. Значение по умолчанию — «en».

ПоискИсторияЧасыОтвет

Ответ на RPC LookupHistoryHours.

Поля
history_hours[]

HistoryHour

Почасовые исторические записи в соответствии с количеством часов и размером страницы, указанными в запросе.

time_zone

TimeZone

Часовой пояс в запрашиваемом месте.

next_page_token

string

Токен для получения следующей страницы.

ПоискPublicAlertsRequest

Запрос LookupPublicAlerts RPC.

Поля
location

LatLng

Обязательно. Местоположение, для которого необходимо получать оповещения о погоде. Сервис вернет оповещения, зона действия которых пересекается с этим местоположением.

page_size

int32

Необязательно. Максимальное количество записей погодных предупреждений для общего пользования, возвращаемых на странице.

page_token

string

Необязательно. Токен страницы, полученный из предыдущего вызова LookupPublicAlerts . Укажите его для получения следующей страницы. При разбиении на страницы все остальные параметры, переданные LookupPublicAlerts должны соответствовать вызову, который предоставил токен страницы.

language_code

string

Необязательно. Позволяет клиенту выбрать язык ответа. Если данные для этого языка не могут быть предоставлены, API использует наиболее близкое соответствие. Допустимые значения основаны на стандарте IETF BCP-47. Значение по умолчанию — «en».

ПоискPublicAlertsResponse

Ответ на LookupPublicAlerts RPC.

Поля
weather_alerts[]

PublicAlerts

Записи оповещений о погоде для населения в соответствии с количеством оповещений и размером страницы, указанными в запросе.

region_code

string

Код региона ISO_3166-1 alpha-2, соответствующий местоположению, указанному в запросе. Регион указывается с использованием ISO_3166-1_alpha-2.

next_page_token

string

Токен, который можно отправить как page_token для получения следующей страницы. Если это поле пропущено, последующих страниц не будет.

MoonEvents

Представляет события, связанные с луной (например, восход луны, заход луны).

Поля
moonrise_times[]

Timestamp

Время, когда верхняя часть Луны появляется над горизонтом (см. https://en.wikipedia.org/wiki/Moonrise_and_moonset) .

ПРИМЕЧАНИЕ: В большинстве случаев в день будет только одно время восхода Луны. В других случаях список может быть пустым (например, если Луна взойдет после полуночи следующего дня). Однако в отдельных случаях (например, в полярных регионах) список может содержать несколько значений. В таких случаях значения сортируются по возрастанию.

moonset_times[]

Timestamp

Время, когда верхняя часть Луны скрывается за горизонтом (см. https://en.wikipedia.org/wiki/Moonrise_and_moonset) .

ПРИМЕЧАНИЕ: В большинстве случаев время захода Луны будет одним в сутки. В других случаях список может быть пустым (например, если Луна заходит после полуночи следующего дня). Однако в отдельных случаях (например, в полярных регионах) список может содержать несколько значений. В таких случаях значения сортируются по возрастанию.

moon_phase

MoonPhase

Фаза Луны (она же лунная фаза).

Фаза Луны

Отмечает фазу Луны (она же лунная фаза).

Перечисления
MOON_PHASE_UNSPECIFIED Неопределенная фаза Луны.
NEW_MOON Луна не освещена солнцем.
WAXING_CRESCENT Луна освещена на 0%-50% с правой стороны в северном полушарии 🌒 и с левой стороны в южном полушарии 🌘.
FIRST_QUARTER Луна освещена на 50,1% с правой стороны в северном полушарии 🌓 и с левой стороны в южном полушарии 🌗.
WAXING_GIBBOUS Луна освещена на 50%-100% с правой стороны в северном полушарии 🌔 и с левой стороны в южном полушарии 🌖.
FULL_MOON Луна полностью освещена.
WANING_GIBBOUS Луна освещена на 50%-100% с левой стороны в северном полушарии 🌖 и с правой стороны в южном полушарии 🌔.
LAST_QUARTER Луна освещена на 50,1% с левой стороны в северном полушарии 🌗 и с правой стороны в южном полушарии 🌓.
WANING_CRESCENT Луна освещена на 0%-50% с левой стороны в северном полушарии 🌘 и с правой стороны в южном полушарии 🌒.

Осадки

Представляет собой набор значений осадков в заданном месте.

Поля
probability

PrecipitationProbability

Вероятность выпадения осадков (значения от 0 до 100).

snow_qpf

QuantitativePrecipitationForecast

Количество снега, измеренное в эквиваленте жидкой воды, накопившееся за определённый период времени. Примечание: QPF — это сокращение от Quantitative Precipitation Forecast (количественный прогноз осадков) (подробнее см. в определении QuantitativePrecipitationForecast).

qpf

QuantitativePrecipitationForecast

Количество осадков, измеренное в жидком водном эквиваленте, накопленное за определённый период времени. Примечание: QPF — это сокращение от Quantitative Precipitation Forecast (количественный прогноз осадков) (подробнее см. в определении QuantitativePrecipitationForecast).

Вероятность осадков

Представляет вероятность выпадения осадков в заданном месте.

Поля
type

PrecipitationType

Код, указывающий тип осадков.

percent

int32

Процент от 0 до 100, указывающий вероятность выпадения осадков.

Тип осадков

Представляет тип осадков в данном месте.

Перечисления
PRECIPITATION_TYPE_UNSPECIFIED Неуказанный тип осадков.
NONE Осадков нет.
SNOW Снеговые осадки.
RAIN Дождевые осадки.
LIGHT_RAIN Небольшие дождевые осадки.
HEAVY_RAIN Сильные ливневые осадки.
RAIN_AND_SNOW Осадки как в виде дождя, так и снега.
SLEET Мокрые осадки.
FREEZING_RAIN Осадки в виде ледяного дождя.

PublicAlerts

Представляет собой оповещения населения о погодных условиях.

Поля
alert_id

string

Уникальный идентификатор этого оповещения.

alert_title

LocalizedText

Локализованное название оповещения.

event_type

WeatherEventType

Тип погодного явления.

area_name

string

Название района, где выдано оповещение.

instruction[]

string

Инструкции, рекомендованные издателем. Обратите внимание: хотя это поле и должно быть локализовано, это не гарантируется.

safety_recommendations[]

SafetyRecommendation

Рекомендации по безопасности для пользователя могут быть предоставлены издателем или другими органами.

timezone_offset

string

Смещение часового пояса относительно UTC для места оповещения. Значение форматируется как строка, заканчивающаяся на «s», например, «-14400s» для 4 часов отставания от UTC.

start_time

Timestamp

Время начала мероприятия.

expiration_time

Timestamp

Время истечения события.

data_source

DataSource

Подробная информация об издателе, выпустившем оповещение.

polygon

string

GeoJSON-представление областей, в которых выдается оповещение.

Данные GeoJSON должны быть в формате RFC 7946 и представлять собой либо полигон (для одной непрерывной области), либо мультиполигон (для нескольких отдельных областей).

Пример:

{ "тип": "Многоугольник", "координаты": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] }

Пример строки MultiPolygon GeoJson выглядит так:

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

description

string

Последний текст с описанием оповещения, выпущенного официальным органом. Обратите внимание: хотя это поле и должно быть локализовано, это не гарантируется.

severity

Severity

Уровень серьезности оповещения.

certainty

Certainty

Уверенность в предупреждении.

urgency

Urgency

Срочность оповещения.

Издатель

Издатель оповещения.

Перечисления
PUBLISHER_UNSPECIFIED Издатель не указан.
AUSTRALIA_ACT_ESA Австралия Австралийская столичная территория
AUSTRALIA_NSW_RFS Новый Южный Уэльс
AUSTRALIA_QLD_QFES Квинсленд
AUSTRALIA_SA_CFS Южная Австралия
METEO_ALARM_AT Meteoalarm / EUMETNET Austria
METEO_ALARM_BS Босния
BRAZIL_CENAD Бразильское агентство по ликвидации последствий стихийных бедствий в Бразилии
BRAZIL_INMET Метеорологическое агентство Бразилии
UK_ENV_AGENCY Великобритания
METEO_ALARM_BG Метеоаларм / ЕВМЕТНЕТ Болгария
METEO_ALARM_CR Хорватия
METEO_ALARM_CY Кипр
METEO_ALARM_CS Чехия
METEO_ALARM_DK Дания
EC_INAMHI Эквадор
METEO_ALARM_FI Meteoalarm / EUMETNET Финляндия
METEO_ALARM_FR Франция
DE_DWD Германия
METEO_ALARM_GB Meteoalarm / EUMETNET Великобритания
METEO_ALARM_GR Греция
METEO_ALARM_HU Венгрия
METEO_ALARM_IS Исландия
METEO_ALARM_IE Ирландия
METEO_ALARM_IT Италия
JM_JMS Ямайка
JMA Япония
METEO_ALARM_NL Метеоаларм / EUMETNET Нидерланды
METEO_ALARM_LV Латвия
METEO_ALARM_LT Литва
METEO_ALARM_LU Люксембург
MEXICO_CIRES Мексика Мексика CIRES
NZ_GEONET Новая Зеландия GeoNet Новой Зеландии
NZ_NMS МетСервис
METEO_ALARM_MK Meteoalarm / EUMETNET Северная Македония
METEO_ALARM_NO Норвегия
PHILIPPINES_PAGASA Филиппины
METEO_ALARM_PL Meteoalarm / EUMETNET Польша
METEO_ALARM_PT Португалия
METEO_ALARM_RO Румыния
METEO_ALARM_RS Сербия
SG_MSS Сингапур
METEO_ALARM_SK Метеоаларм / EUMETNET Словакия
METEO_ALARM_SI Словения
SB_MET Соломоновы Острова
METEO_ALARM_ES Meteoalarm / EUMETNET Испания
METEO_ALARM_SE Швеция
METEO_ALARM_CH Швейцария
TAIWAN_NCDR Тайвань
NOAA NOAA США
WCATWC Национальный центр предупреждения о цунами

Количественный прогноз осадков

Представляет собой ожидаемое количество талых осадков, накопленных за определенный период времени на определенной территории (ссылка: https://en.wikipedia.org/wiki/Quantitative_precipitation_forecast ) — обычно для краткости обозначается QPF.

Поля
unit

Unit

Код единицы измерения количества накопленных осадков.

quantity

float

Количество осадков, измеренное в эквиваленте жидкой воды, накопившееся за определенный период времени.

Единица

Представляет собой единицу измерения количества накопленных осадков.

Перечисления
UNIT_UNSPECIFIED Неуказанная единица измерения осадков.
MILLIMETERS Количество осадков измеряется в миллиметрах.
INCHES Количество осадков измеряется в дюймах.

Рекомендации по безопасности

Представляет собой рекомендацию по безопасности.

Поля
directive

string

Директива пользователю. Обратите внимание, что, хотя это поле и должно быть локализовано, это не гарантируется.

subtext

string

Необязательный подтекст директивы, который может содержать дополнительный контекст для пользователя. Обратите внимание: хотя это поле и должно быть локализовано, это не гарантируется.

Серьезность

Код, обозначающий серьезность события, о котором идет речь в оповещении.

Перечисления
SEVERITY_UNKNOWN Степень серьезности неизвестна.
EXTREME Чрезвычайная угроза жизни или имуществу.
SEVERE Значительная угроза жизни или имуществу.
MODERATE Возможная угроза жизни или имуществу.
MINOR Незначительная угроза жизни или имуществу.

SpeedUnit

Представляет собой единицу измерения скорости.

Перечисления
SPEED_UNIT_UNSPECIFIED Единица измерения скорости не указана.
KILOMETERS_PER_HOUR Скорость измеряется в километрах в час.
MILES_PER_HOUR Скорость измеряется в милях в час.

SunEvents

Представляет события, связанные с солнцем (например, восход, закат).

Поля
sunrise_time

Timestamp

Время восхода солнца.

ПРИМЕЧАНИЕ: В некоторых случаях (например, к северу от Полярного круга) время восхода Солнца может отсутствовать. В таких случаях это поле будет не заполнено.

sunset_time

Timestamp

Время, когда солнце садится.

ПРИМЕЧАНИЕ: В некоторых случаях (например, к северу от Полярного круга) время заката может отсутствовать. В таких случаях это поле будет не заполнено.

Температура

Представляет значение температуры.

Поля
unit

TemperatureUnit

Код единицы измерения температуры.

degrees

float

Значение температуры (в градусах) в указанных единицах измерения.

Единица измерения температуры

Представляет собой единицу измерения температуры.

Перечисления
TEMPERATURE_UNIT_UNSPECIFIED Единица измерения температуры не указана.
CELSIUS Температура измеряется в градусах Цельсия.
FAHRENHEIT Температура измеряется в градусах Фаренгейта.

UnitsSystem

Представляет собой систему единиц, используемую для измерения величин.

Перечисления
UNITS_SYSTEM_UNSPECIFIED Система единиц измерения не определена.
IMPERIAL Имперская система единиц (например, градусы Фаренгейта, мили и т. д.).
METRIC Метрическая система единиц (например, градусы Цельсия, километры и т. д.).

Срочность

Код, обозначающий срочность события, о котором идет речь в оповещении.

Перечисления
URGENCY_UNKNOWN Срочность неизвестна.
IMMEDIATE Ответные меры ДОЛЖНЫ быть приняты немедленно.
EXPECTED Ответные действия ДОЛЖНЫ быть предприняты в ближайшее время (в течение следующего часа).
FUTURE Ответные действия ДОЛЖНЫ быть предприняты в ближайшем будущем.
PAST Реагировать на ситуацию больше не требуется.

Видимость

Представляет собой условия видимости — расстояние, на котором можно различить объекты.

Поля
unit

Unit

Код, представляющий единицу измерения расстояния.

distance

float

Расстояние видимости в указанных единицах измерения.

Единица

Представляет собой единицу измерения дальности видимости.

Перечисления
UNIT_UNSPECIFIED Единица видимости не указана.
KILOMETERS Видимость измеряется в километрах.
MILES Видимость измеряется в милях.

ПогодаСостояние

Представляет собой погодные условия для определенного места в определенный период времени.

Отказ от ответственности: Значки погоды и коды погодных условий могут быть изменены. Google может добавлять новые коды и значки или обновлять существующие по мере необходимости. Мы рекомендуем вам регулярно обращаться к этой документации для получения самой актуальной информации.

Поля
icon_base_uri

string

Базовый URI значка без учёта расширения типа файла. Чтобы отобразить значок, добавьте к этому URI тему (при необходимости) и расширение типа файла ( .png или .svg ). По умолчанию значок имеет светлую тему, но можно добавить _dark для тёмного режима. Например: "https://maps.gstatic.com/weather/v1/dust.svg" или "https://maps.gstatic.com/weather/v1/dust_dark.svg", где icon_base_uri — это "https://maps.gstatic.com/weather/v1/dust".

description

LocalizedText

Текстовое описание данного погодного явления (локализованное).

type

Type

Тип погодных условий.

Тип

Отмечает тип погодных условий в контексте элемента прогноза.

Перечисления
TYPE_UNSPECIFIED Погодные условия не определены.
CLEAR Облаков нет.
MOSTLY_CLEAR Периодические облака.
PARTLY_CLOUDY Переменная облачность (небольшие облака).
MOSTLY_CLOUDY Преимущественно облачно (больше облаков, чем солнца).
CLOUDY Облачно (сплошные облака, солнца нет).
WINDY Сильный ветер.
WIND_AND_RAIN Сильный ветер с осадками.
LIGHT_RAIN_SHOWERS Небольшой кратковременный дождь.
CHANCE_OF_SHOWERS Возможны кратковременные дожди.
SCATTERED_SHOWERS Кратковременный дождь.
RAIN_SHOWERS Ливнями считаются осадки, которые длятся меньше времени, чем дождь, и характеризуются внезапностью начала и окончания, а также быстрым изменением интенсивности.
HEAVY_RAIN_SHOWERS Интенсивные ливни.
LIGHT_TO_MODERATE_RAIN Дождь (от небольшого до умеренного).
MODERATE_TO_HEAVY_RAIN Дождь (от умеренного до сильного).
RAIN Умеренный дождь.
LIGHT_RAIN Небольшой дождь.
HEAVY_RAIN Сильный дождь.
RAIN_PERIODICALLY_HEAVY Периодически сильные дожди.
LIGHT_SNOW_SHOWERS Небольшой снег, идущий с разной интенсивностью в течение коротких промежутков времени.
CHANCE_OF_SNOW_SHOWERS Возможны снегопады.
SCATTERED_SNOW_SHOWERS Снег, падающий с разной интенсивностью в течение коротких промежутков времени.
SNOW_SHOWERS Снегопады.
HEAVY_SNOW_SHOWERS Сильные снегопады.
LIGHT_TO_MODERATE_SNOW Слабый или умеренный снег.
MODERATE_TO_HEAVY_SNOW Умеренный или сильный снегопад.
SNOW Умеренный снег.
LIGHT_SNOW Небольшой снег.
HEAVY_SNOW Сильный снегопад.
SNOWSTORM Снег, возможны грозы и молнии.
SNOW_PERIODICALLY_HEAVY Снег, временами сильный.
HEAVY_SNOW_STORM Сильный снегопад, возможны гром и молнии.
BLOWING_SNOW Снег с сильным ветром.
RAIN_AND_SNOW Смесь дождя и снега.
HAIL Град.
HAIL_SHOWERS Град, падающий с разной интенсивностью в течение коротких промежутков времени.
THUNDERSTORM Гроза.
THUNDERSHOWER Ливень, сопровождающийся громом и молнией.
LIGHT_THUNDERSTORM_RAIN Небольшой грозовой дождь.
SCATTERED_THUNDERSTORMS Грозы с дождями различной интенсивности в течение коротких промежутков времени.
HEAVY_THUNDERSTORM Сильная гроза.

WeatherEventType

Тип погодного явления.

Перечисления
WEATHER_EVENT_TYPE_UNSPECIFIED Неуказанный тип погодного явления.
ACID_RAIN Кислотные дожди.
AFTERSHOCK Афтершоковое событие.
AVALANCHE Сход лавины.
BLIZZARD Событие «Метель».
BLOWING_SNOW Снежная метель.
BUSHFIRE Лесной пожар.
COASTAL_FLOOD Прибрежное наводнение.
COASTAL_HAZARD Опасное прибрежное явление.
COLD Холодное событие.
CYCLONE Циклон.
DROUGHT Засуха.
DUST_STORM Пыльная буря.
EARTHQUAKE Землетрясение.
EXTRATROPICAL_CYCLONE Дополнительный тропический циклон.
FIRE Пожар.
FIRE_WEATHER Пожароопасное погодное явление.
FLASH_FLOOD Внезапное наводнение.
FLOOD Наводнение.
FOG Туманное явление.
FREEZING Событие замораживания.
FREEZING_AIR_TEMPERATURE Событие, связанное с отрицательными температурами воздуха.
FREEZING_DRIZZLE Ледяная морось.
FREEZING_RAIN_EVENT Ледяной дождь.
FROST Морозное событие.
GALE Штормовое событие.
GLAZE Глазурное мероприятие.
HAIL Событие «Град».
HAZARDOUS_SEAS Опасное морское событие.
HEAT Тепловое событие.
HUMIDITY Событие влажности.
HURRICANE Ураганное событие.
ICE_STORM Ледяной шторм.
INDUSTRIAL_FIRE Промышленный пожар.
LAKE_EFFECT_SNOW Снежный эффект озера.
LANDSLIDE Оползень.
MONSOON Муссонное явление.
MUDDY_FLOOD Грязевое наводнение.
OUTFLOW Событие оттока.
RADIATION Радиационное событие.
RAIN_EVENT Дождь.
RIVER_FLOODING Разлив реки.
SEVERE_THUNDERSTORM_WARNING Предупреждение о сильной грозе.
SNOWSQUALL Снежный шквал.
SNOW_EVENT Снежное событие.
STORM Штормовое событие.
STORM_SURGE Штормовой нагон.
THUNDER Громовое событие.
THUNDERSTORM Гроза.
TORNADO Событие торнадо.
TORNADO_WARNING Предупреждение о торнадо.
TROPICAL_CYCLONE Тропический циклон.
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES Предупреждения о тропических циклонах и наблюдение за событиями.
TROPICAL_DISTURBANCE Тропическое возмущение.
TROPICAL_STORM Тропический шторм.
TSUNAMI Цунами.
TYPHOON Тайфун.
VOLCANIC_ASH Выпадение вулканического пепла.
VOLCANIC_ERUPTION Событие извержения вулкана.
WILDFIRE Лесной пожар.
WIND Ветровое явление.
WIND_CHILL Событие, вызванное ветром и охлаждением.
WIND_WAVE Ветровое волнение.
WINTER_STORM Зимний шторм.

Ветер

Представляет собой набор свойств ветра.

Поля
direction

WindDirection

Направление ветра, угол, под которым он дует.

speed

WindSpeed

Скорость ветра.

gust

WindSpeed

Порыв ветра (резкое увеличение скорости ветра).

Направление Ветра

Обозначает направление, откуда дует ветер.

Поля
cardinal

CardinalDirection

Код, обозначающий сторону света, откуда дует ветер.

degrees

int32

Направление ветра в градусах (значения от 0 до 360).

Скорость ветра

Представляет скорость ветра.

Поля
unit

SpeedUnit

Код, представляющий единицу измерения скорости ветра.

value

float

Значение скорости ветра.