Получайте оповещения о погоде

Конечная точка publicAlerts предоставляет подробную информацию о конкретных предупреждениях о погодных явлениях, выпущенных авторитетными национальными и международными агентствами. Эти оповещения содержат важную информацию, потенциально способную спасти жизни.

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

  • Осадки: дождь, снег, град, засухи и многое другое
  • Экстремальные температуры: холод, жара, заморозки, мороз, ветер и влажность
  • Ветровые и штормовые явления: метели, ураганы, торнадо, тропические штормы, грозы и многое другое.
  • Ухудшение видимости: туман, пыльные бури и метель
  • Опасности, связанные с водой: наводнения, цунами, штормовые нагоны, прибрежные опасности и многое другое.
  • Геофизические и геологические события: землетрясения, оползни и вулканическая активность
  • Пожары: лесные пожары, пожароопасная погода и многое другое

Полный список поддерживаемых погодных явлений см. в разделе Типы погодных явлений .

Оповещения могут содержать или не содержать локализованные описания в зависимости от того, какие данные доступны в источнике данных . Из-за ограничений источника данных информация предоставляется «как есть» (необработанный контент). Подробнее об источниках оповещений о погоде см. в разделе «Источники данных» .

API возвращает следующую информацию для данного предупреждения о погоде:

  • Тип погодного явления, связанного с оповещением
  • Список пострадавших территорий вместе с координатами, определяющими географические границы этих территорий.
  • Краткое описание погодного явления в одном предложении
  • Уровни серьезности, определенности и срочности
  • Описание рекомендуемых к действию инструкций для целевой аудитории
  • Рекомендации по безопасности
  • Время начала и окончания оповещения
  • Название и веб-сайт издающего органа

API Explorer позволяет вам делать живые запросы, чтобы вы могли ознакомиться с API и его параметрами:

О запросах на оповещения о погоде

Чтобы запросить информацию о погодных предупреждениях, отправьте HTTP-запрос GET по адресу:

https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE

Включите координаты широты и долготы местоположения в параметры URL-адреса запроса.

О реагировании на оповещения о погодных условиях

API погоды возвращает следующие поля в теле ответа:

Поле Тип Описание Обязательно или необязательно
alertId Нить Идентификатор оповещения. Его также можно найти на сайте поставщика данных. Необходимый
alertTitle Нить Заголовок оповещения, описывающий погодное явление.

Примечание: это единственная строка, которая переводится, если в запрос включен параметр кода языка.		 Необходимый
eventType Перечисление Тип погодного явления, связанного с оповещением.

Полный список поддерживаемых погодных явлений см. в разделе Типы погодных явлений .		 Необходимый
areaName Нить Название географической области, затронутой оповещением, включая запрошенное местоположение. Необходимый
polygon Нить Координаты, определяющие замкнутую пространственную область оповещения. Необязательный
description Нить Короткая фраза, описывающая событие на указанном языке (например, «Предупреждение о торнадо»). Необязательный
severity Перечисление Уровень серьезности оповещения:
  • Экстремальный: чрезвычайная угроза жизни или имуществу
  • Серьёзная: значительная угроза жизни или имуществу
  • Умеренная: возможная угроза жизни или имуществу
  • Незначительная: минимальная или неизвестная угроза жизни или имуществу
  • Неизвестно: степень серьезности неизвестна
 Необязательный
certainty Перечисление Уровень уверенности в предупреждении:
  • Наблюдается: установлено, что произошло или продолжается
  • Очень вероятно: весьма вероятно, что произошло или продолжается
  • Вероятно: Вероятно (p > ~50%), что произошло или продолжается
  • Возможно: возможно, но вряд ли произошло или продолжается (p <= ~50%)
  • Маловероятно: не ожидается (p ~ 0)
  • Неизвестно: Точность неизвестна
 Необязательный
urgency Перечисление Уровень срочности оповещения:
  • Немедленно: Ответные действия ДОЛЖНЫ быть предприняты немедленно.
  • Ожидается: Ответные действия ДОЛЖНЫ быть предприняты в ближайшее время (в течение следующего часа)
  • Будущее: В ближайшем будущем необходимо предпринять ответные действия.
  • Прошлое: Реагирование больше не требуется
  • Неизвестно: Срочность неизвестна
 Необязательный
instruction Нить Описание четких инструкций действий для целевой аудитории. Необязательный
safetyRecommendations Нить Рекомендации по безопасности, основанные на кодексах государственных органов. Включают директивы высшего уровня и подтекст с дополнительной информацией. Необязательный
timezoneOffset Нить Смещение часового пояса события в формате +/-ЧЧ:ММ. Необходимый
startTime ДатаВремя Эффективная дата и время эпохи (время UTC) информации в оповещении. Необязательный
expirationTime ДатаВремя Дата и время эпохи (UTC), когда ожидается окончание действия оповещения. Для событий неопределённой длительности может быть нулевым; в этом случае заголовок будет указывать на то, что событие «вступило в силу». Необязательный
dataSource Перечисление Данные об источнике, включая издателя, имя и URL. Необходимый
regionCode Перечисление Код региона запрашиваемого местоположения. Необязательный

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

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

Поставщики, включённые в фид, следуют правилам Google по оповещению общественности . Google может обновить список поставщиков в любое время.

Страна Агентство
Австралия Агентство экстренных служб столичной территории (ACT ESA)
Сельская пожарная служба Нового Южного Уэльса (NSW RFS)
Пожарная служба Южной Австралии (SA CFS)
Пожарная служба Тасмании (TFS)
Пожарная и аварийно-спасательная служба Квинсленда (QFES)
Австрия GeoSphere Austria через MeteoAlarm
Бельгия Королевский метеорологический институт Бельгии через MeteoAlarm
Босния и Герцеговина Федеральный гидрометеорологический институт (ФХМЗ) через MeteoAlarm
Болгария Национальный институт метеорологии и гидрологии через MeteoAlarm
Бразилия Национальный центр борьбы с рисками и бедствиями (СЕНАД)
Национальный институт метеорологии (ИНМЕТ)
Колумбия Национальное единство действий по борьбе с бедствиями (UNGRD)
Берег Слоновой Кости Société d'Exploitation et de Developpement Aéroportuaire, Aeronautique et Météorologique
Хорватия Хорватская метеорологическая и гидрологическая служба через MeteoAlarm
Кипр Департамент метеорологии через MeteoAlarm
Чехия Чешский гидрометеорологический институт через MeteoAlarm
Дания Датский метеорологический институт через MeteoAlarm
Эквадор Национальный институт метеорологии и гидрологии
Эстония Министерство климата через MeteoAlarm
Финляндия Финский метеорологический институт через MeteoAlarm
Франция Метео-Франс через MeteoAlarm
Германия DWD — Немецкая метеорологическая служба
Греция Греческая национальная метеорологическая служба через MeteoAlarm
Гвинея Национальное метеорологическое агентство
Венгрия Некоммерческая организация HungaroMet Zrt через MeteoAlarm
Исландия Исландское метеорологическое бюро через MeteoAlarm
Ирландия Встретился с Эйранн через MeteoAlarm
Италия Итальянская метеорологическая служба через MeteoAlarm
Ямайка Метеорологическая служба Ямайки
Япония Японское метеорологическое агентство (ЯМА)
Латвия Латвийский центр окружающей среды, геологии и метеорологии через MeteoAlarm
Литва Литовская гидрометеорологическая служба через MeteoAlarm
Люксембург MeteoLux через MeteoAlarm
Мадагаскар Метео Мадагаскар
Мексика Центр приборостроения и системного реестра AC (CIRES)
Нидерланды Королевский Нидерландский метеорологический институт через MeteoAlarm
Северная Македония Национальная гидрометеорологическая служба через MeteoAlarm
Норвегия Норвежский метеорологический институт через MeteoAlarm
Новая Зеландия GNS Science (GeoNet)
МетСервис
Филиппины Филиппинское управление атмосферных, геофизических и астрономических служб (PAGASA)
Польша Институт метеорологии и водного хозяйства через MeteoAlarm
Португалия Португальский институт моря и атмосферы через MeteoAlarm
Румыния Национальное метеорологическое управление через MeteoAlarm
Сербия Республиканский гидрометеорологический институт Сербии через MeteoAlarm
Сингапур Метеорологическая служба Сингапура
Словакия Словацкий гидрометеорологический институт через MeteoAlarm
Словения Гидрометеорологический институт Словении через MeteoAlarm
Соломоновы Острова Метеорологическая служба Соломоновых Островов
Южная Корея Корейская метеорологическая администрация
Испания Государственное метеорологическое агентство через MeteoAlarm
Швеция Шведский метеорологический и гидрологический институт через MeteoAlarm
Швейцария Федеральное ведомство метеорологии и климатологии MeteoSwiss через MeteoAlarm
Тайвань Национальный научно-технический центр по уменьшению опасности стихийных бедствий (NCDR)
Таиланд Метеорологический департамент Таиланда
Великобритания Метеорологическое бюро через MeteoAlarm
Агентство по охране окружающей среды Великобритании
Соединенные Штаты Национальный центр предупреждения о цунами
Национальная метеорологическая служба США
Вьетнам Национальный центр гидрометеорологического прогнозирования

Атрибуция

На всех дисплеях, где представлены данные, приложение клиента должно включать ссылку на первоисточник с помощью поля dataSource :

"dataSource": {
        "publisher": "NOAA",
        "name": "National Weather Service",
        "authorityUri": "https://www.weather.gov/"
      }

Атрибуция должна включать полное название источника данных (как указано в поле name ») и гиперссылку на источник данных с использованием URL-адреса, указанного в поле authorityUri (например, « Национальная метеорологическая служба »).

Типы погодных явлений

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

Типы погодных явлений
ACID_RAIN
AVALANCHE
BLIZZARD
BLOWING_SNOW
COASTAL_FLOOD
COASTAL_HAZARD
COLD
CYCLONE
DROUGHT
EXTRATROPICAL_CYCLONE
FIRE_WEATHER
FLASH_FLOOD
FLOOD
FOG
FREEZING
FREEZING_AIR_TEMPERATURE
FREEZING_DRIZZLE
FREEZING_RAIN
FROST
GALE
GLAZE
HAIL
HAZARDOUS_SEAS
HEAT
HUMIDITY
HURRICANE
ICE_STORM
LAKE_EFFECT_SNOW
MONSOON
MUDDY_FLOOD
OUTFLOW
RAIN		 RIVER_FLOODING
SEVERE_THUNDERSTORM_WARNING
SNOW
SNOWSQUALL
STORM
STORM_SURGE
THUNDER
THUNDERSTORM
TORNADO
TORNADO_WARNING
TROPICAL_CYCLONE
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES
TROPICAL_DISTURBANCE
TROPICAL_STORM
TYPHOON
WIND
WIND_CHILL
WIND_WAVE
WINTER_STORM
WILDFIRE
BUSHFIRE
FIRE
LANDSLIDE
EARTHQUAKE
DUST_STORM
AFTERSHOCK
TSUNAMI
VOLCANIC_ASH
VOLCANIC_ERUPTION
RADIATION

Поведение перевода ответа

Google предоставляет перевод только для поля alertTitle . Другие поля, такие как eventType , areaName , instruction и safetyRecommendations , также могут быть переведены в зависимости от языковой поддержки исходного источника данных. Однако Google не может предоставить независимые переводы для этих полей.

На основе параметра languageCode , включенного в запрос, для поля alertTitle ожидаются следующие варианты поведения:

  • Поддерживаемый languageCode : если запрошенный languageCode указан и поддерживается, ответ возвращается на запрошенном языке.
  • Неподдерживаемый languageCode : в случаях, когда запрошенный languageCode не поддерживается и близкая альтернатива не может быть найдена, конечная точка возвращает ответ на английском языке по умолчанию.
  • languageCode не указан: конечная точка возвращает ответ на английском языке по умолчанию.

Пример запроса на оповещение о погоде

В следующем примере запрашивается информация о погодном предупреждении для города в Северной Каролине:

curl -X GET "https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=35.824635&location.longitude=-78.3168047&languageCode=en"

Текст ответа выглядит следующим образом:

{
  "weatherAlerts": [
    {
      "alertId": "urn:oid:2.49.0.1.840.0.2416b1b5a6f51d29ef4b94948328dca303fbbb5c.001.1",
      "alertTitle": {
        "text": "Flash Flood Warning",
        "languageCode": "en"
      },
      "eventType": "FLASH_FLOOD",
      "areaName": "Franklin, NC; Johnston, NC; Nash, NC; Wake, NC",
      "polygon": "{\"type\":\"Polygon\",\"coordinates\":[[[-78.450000,35.820000],[-78.410000,35.730000],[-78.280000,35.660000],
        [-78.180000,35.740000],[-77.840000,36.150000],[-77.890000,36.140000],[-77.900000,36.160000],[-77.920000,36.170000],
        [-77.930000,36.190000], [-77.940000,36.190000],[-77.950000,36.180000],[-77.970000,36.190000],[-77.970000,36.180000],
        [-77.980000,36.180000],[-78.010000,36.210000],[-78.040000,36.210000],[-78.110000,36.210000],[-78.130000,36.230000],
        [-78.350000,35.940000],[-78.450000,35.820000]]]}",
      "description": "FFWRAH\n\nThe National Weather Service in Raleigh has issued a\n\n* Flash Flood Warning for...
        \nEastern Franklin County in central North Carolina...\nNorth Central Johnston County in central North Carolina...
        \nWestern Nash County in central North Carolina...\nEast Central Wake County in central North Carolina...
        \n\n* Until 530 PM EDT.\n\n* At 224 PM EDT, local law enforcement reported flash flooding in\nSpring Hope. Between 3 and 5 inches of rain have fallen.
        \nAdditional rainfall amounts of 1 to 3 inches are possible in the\nwarned area.\n\nHAZARD...Life threatening flash flooding.
        Heavy rain producing\nflash flooding.\n\nSOURCE...Law enforcement reported.\n\nIMPACT...Life threatening flash flooding of creeks and streams,\nurban areas,
        highways, streets and underpasses.\n\n* Some locations that will experience flash flooding include...
        \nZebulon, Bunn, Wendell, Spring Hope, Middlesex, Castalia,\nCenterville, Pilot, Emit and Aventon.",
      "severity": "SEVERE",
      "certainty": "LIKELY",
      "urgency": "IMMEDIATE",
      "instruction": [
        "Turn around, don't drown when encountering flooded roads. Most flood\ndeaths occur in vehicles."
      ],
      "safetyRecommendations": [
        {
          "directive": "Build an emergency kit and make a family communications plan.",
          "subtext": "Follow the instructions at http://www.ready.gov/build-a-kit for building 
            an emergency kit and http://www.ready.gov/make-a-plan for a family communications plan."
        },
        {
          "directive": "Be aware that flash flooding can occur. ",
          "subtext": "If there is any possibility of a flash flood, move immediately to higher ground. Do not wait for instructions to move."
        },
        ...
      ],
      "timezoneOffset": "-14400s",
      "startTime": "2025-08-06T18:24:00Z",
      "expirationTime": "2025-08-06T21:30:00Z",
      "dataSource": {
        "publisher": "NOAA",
        "name": "National Weather Service",
        "authorityUri": "https://www.weather.gov/"
      }
    }
  ],
  "regionCode": "US"
}

Попробуйте!

API Explorer позволяет вам делать образцы запросов, чтобы вы могли ознакомиться с API и его параметрами.

  1. Выберите значок API api на правой стороне страницы.

  2. При желании отредактируйте параметры запроса.

  3. Нажмите кнопку «Выполнить» . В диалоговом окне выберите учётную запись, которую вы хотите использовать для отправки запроса.

  4. На панели обозревателя API выберите значок полноэкранного режима, чтобы развернуть окно обозревателя API.