Weather - Get Severe Weather Alerts

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

Get Severe Weather Alerts API представляет собой HTTP-запросGET, который возвращает предупреждения о неблагоприятных погодных условиях, доступные по всему миру как от официальных государственных метеорологических агентств, так и от ведущих глобальных и региональных поставщиков предупреждений о погоде. Сервис может возвращать такие сведения, как тип оповещения, категория, уровень и подробное описание активных серьезных предупреждений для запрашиваемого местоположения, таких как ураганы, грозы, молнии, волны тепла или лесные пожары. Дополнительные сведения см. в разделе Запрос предупреждений о суровых погодных условиях

GET {endpoint}/weather/severe/alerts/json?api-version=1.1&query={query}

GET {endpoint}/weather/severe/alerts/json?api-version=1.1&query={query}&language={language}&details={details}

Параметры URI

Заголовок запроса

Ответы

Безопасность

AadToken

Это Microsoft Entra OAuth 2.0 потоки. В сочетании с управлением Azure ролевым доступом он может использоваться для управления доступом к Azure Maps REST API. Ролевые контроли доступа Azure используются для обозначения доступа к одной или нескольким учетной записи ресурсов или подресурсам Azure Maps. Любой пользователь, группа или принципал сервиса может получить доступ через встроенную роль или пользовательскую роль, состоящую из одного или нескольких разрешений Azure Maps REST API.\n\nДля реализации сценариев рекомендуем ознакомиться с концепциями аутентификационные концепции. В заключение, это определение безопасности предоставляет решение для моделирования приложений с помощью объектов, способных контролировать доступ к определённым API и областям видимости.\n\n#### Примечания\n* Это определение безопасности требует использование заголовка x-ms-client-id для указания, к какому Azure Maps ресурсу приложение запрашивает доступ. Её можно получить через API управления Maps.\n* \nAuthorization URL специфичен для экземпляра публичного облака Azure. Облака Sovereign имеют уникальные URL-адреса авторизации и конфигурации Microsoft Entra ID. \n* \nУправление доступом на основе ролей Azure настраивается с плоскости управления Azure через портал Azure, PowerShell, CLI, Azure SDKs или REST API.\n* \nИспользование Azure Maps Web SDK позволяет настраивать приложение на основе конфигурации для нескольких сценариев использования.\n* Для получения дополнительной информации о платформа удостоверений Майкрософт см. платформа удостоверений Майкрософт обзор.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

subscription-key

Это общий ключ, который создаётся при Создайте Azure Maps аккаунт в Azure-портале или с помощью PowerShell, CLI, Azure SDKs или REST API.\n\n С помощью этого ключа любое приложение может получить доступ ко всем REST API. Другими словами, этот ключ может использоваться как мастер-ключ на счете, на котором они выпущены.\n\n Для публично открытых приложений мы рекомендуем использовать подход confidential client applications для доступа к Azure Maps REST API, чтобы ваш ключ можно было безопасно хранить.

Тип: apiKey
В: header

SAS Token

Это токен общего доступа, созданный из операции List SAS на ресурсе Azure Maps/c0> через плоскость управления Azure через портал Azure, PowerShell, CLI, Azure SDKs или REST API.\n\n С помощью этого токена любое приложение имеет право на доступ с помощью Azure ролевые контроли доступа и тонкий контроль истечения срока действия, скорости и региона использования конкретного токена. Другими словами, SAS Token может использоваться для того, чтобы приложения могли управлять доступом более защищённо, чем общий ключ.\n\n Для публично открытых приложений мы рекомендуем настроить конкретный список разрешённых источников на ресурсе аккаунта Map , чтобы ограничить злоупотребления рендерингом и регулярно продлевать токен SAS.

Тип: apiKey
В: header

Примеры

Successfully retrieve severe weather alerts

GET {endpoint}/weather/severe/alerts/json?api-version=1.1&query=48.057,-81.091

{
  "results": [
    {
      "description": {
        "english": "Heat Warning",
        "localized": "Heat Warning"
      },
      "alertAreas": [
        {
          "name": "Kirkland Lake - Englehart",
          "alertDetails": "\nA heat event continues through Thursday.\n\nDaytime high temperatures in the low thirties with overnight lows near 18 degrees Celsius are expected to continue until Thursday. Humidex values are expected to reach between 36 and 40 today. Cooler air will move into the region Thursday night. \n\nPlease refer to your public forecast for further details on expected temperatures.\n\nHot and humid air can also bring deteriorating air quality and can result in the air quality health index to approach the high risk category.\n\n###\n\nExtreme heat affects everyone.\n\nThe risks are greater for young children, pregnant women, older adults, people with chronic illnesses and people working or exercising outdoors.\n\nWatch for the effects of heat illness: swelling, rash, cramps, fainting, heat exhaustion, heat stroke and the worsening of some health conditions.\n\nPlease continue to monitor alerts and forecasts issued by Environment Canada. To report severe weather, send an email to ONstorm@canada.ca or tweet reports using #ONStorm.\n",
          "alertDetailsLanguageCode": "en-CA",
          "endTime": "2020-07-02T07:16:03+00:00",
          "latestStatus": {
            "english": "Continue",
            "localized": "Continue"
          },
          "startTime": "2020-06-29T19:44:00+00:00",
          "summary": "Heat Warning in effect until Thursday, 3:16 AM EDT.  Source: Environment Canada"
        }
      ],
      "alertId": 242621,
      "category": "NON-PRECIPITATION",
      "countryCode": "CA",
      "priority": 31,
      "source": "Environment Canada",
      "sourceId": 3
    },
    {
      "description": {
        "english": "Heat Warning",
        "localized": "Heat Warning"
      },
      "alertAreas": [
        {
          "name": "Kirkland Lake - Englehart",
          "alertDetails": "\nA heat event is expected through Thursday.  \n\nDaytime high temperatures in the low thirties on Wednesday and Thursday with overnight lows near 18 degrees Celsius are expected. This heat event may be extended into the weekend with daytime high temperatures near 30 degrees Celsius. \n\nPlease refer to your public forecast for further details on expected temperatures.  \n\nHot and humid air can also bring deteriorating air quality and can result in the Air Quality Health Index to approach the high risk category.\n\n###\n\nExtreme heat affects everyone.\n\nThe risks are greater for young children, pregnant women, older adults, people with chronic illnesses and people working or exercising outdoors.\n\nPlease continue to monitor alerts and forecasts issued by Environment Canada. To report severe weather, send an email to ONstorm@canada.ca or tweet reports using #ONStorm.\n",
          "alertDetailsLanguageCode": "en-CA",
          "endTime": "2020-07-02T01:25:59+00:00",
          "latestStatus": {
            "english": "New",
            "localized": "New"
          },
          "startTime": "2020-07-01T09:25:59+00:00",
          "summary": "Heat Warning in effect until 9:25 PM EDT.  Source: Environment Canada"
        }
      ],
      "alertId": 242633,
      "category": "NON-PRECIPITATION",
      "countryCode": "CA",
      "priority": 31,
      "source": "Environment Canada",
      "sourceId": 3
    }
  ]
}

Определения

AlertArea

Информация о предупреждении о суровых погодных условиях, выпущенном в пострадавшей зоне. Если для одного и того же расположения активно несколько оповещений, они будут возвращаться в порядке priority ответа API, при этом оповещение с наивысшим приоритетом будет возвращено в верхней части ответа.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Сведения об ошибке.

ErrorResponse

Обычный ответ на ошибку для всех API Azure Resource Manager для возврата деталей ошибок при неудачных операциях. (Это также следует формату ответа об ошибках OData.).

JsonFormat

Требуемый формат ответа. Поддерживается только json формат.

LatestStatus

Последний статус тревоги в текущей области.

LatestStatusKeyword

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

SevereWeatherAlert

Информация о предупреждении о суровой погоде.

SevereWeatherAlertDescription

Описание предупреждения о суровой погоде.

SevereWeatherAlertsResult

Этот объект возвращается в результате успешного вызова Get Severe Weather Alerts.