Method: publicAlerts.lookup

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

HTTP-запрос

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

URL использует синтаксис перекодировки gRPC .

Параметры запроса

Параметры
location

object ( LatLng )

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

pageSize

integer

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

pageToken

string

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

languageCode

string

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

Текст запроса

Тело запроса должно быть пустым.

Тело ответа

Ответ на RPC publicAlerts.lookup.

В случае успеха тело ответа содержит данные со следующей структурой:

JSON-представление 
{
  "weatherAlerts": [
    {
      object (PublicAlerts)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
Поля
weatherAlerts[]

object ( PublicAlerts )

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

regionCode

string

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

nextPageToken

string

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

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

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

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

PublicAlerts

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

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)
}
Поля
alertId

string

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

alertTitle

object ( LocalizedText )

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

eventType

enum ( WeatherEventType )

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

areaName

string

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

instruction[]

string

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

safetyRecommendations[]

object ( SafetyRecommendation )

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

timezoneOffset

string

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

startTime

string ( Timestamp format)

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

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

expirationTime

string ( Timestamp format)

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

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

dataSource

object ( 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

enum ( Severity )

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

certainty

enum ( Certainty )

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

urgency

enum ( Urgency )

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

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 Зимний шторм.

Серьезность

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

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

Уверенность

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

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

Срочность

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

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

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

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

JSON-представление 
{
  "directive": string,
  "subtext": string
}
Поля
directive

string

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

subtext

string

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

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

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

JSON-представление 
{
  "publisher": enum (Publisher),
  "name": string,
  "authorityUri": string
}
Поля
publisher

enum ( Publisher )

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

name

string

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

authorityUri

string

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

Издатель

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

Перечисления
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 Национальный центр предупреждения о цунами