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

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

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