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

Конечная точка 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 прогноза погоды возвращает в теле ответа следующие поля:

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

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

Список поставщиков услуг, включенных в ленту, соответствует рекомендациям 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 в правой части страницы.

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

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

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