получать оповещения о погоде;

Конечная точка 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 запроса координаты широты и долготы местоположения.

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

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

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

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

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

Атрибуция

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

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

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

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

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

Перевод ответов

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. Нажмите кнопку Execute (Выполнить). В диалоговом окне выберите аккаунт, который хотите использовать для отправки запроса.

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