Weather - Get Severe Weather Alerts

Verwenden Sie diese Option, um Informationen über Unwetterbedingungen wie Hurrikane, Gewitter, Überschwemmungen, Blitzschlag, Hitzewellen oder Waldbrände für einen bestimmten Ort zu erhalten.
Unwetterphänomene können unseren Alltag und unsere Geschäftsabläufe erheblich beeinträchtigen. So können beispielsweise extreme Wetterbedingungen wie tropische Stürme, starke Winde oder Überschwemmungen Straßen sperren und Logistikunternehmen dazu zwingen, ihre Flotte umzuleiten, was zu Verzögerungen beim Erreichen von Zielen führt und die Kühlkette von gekühlten Lebensmitteln unterbricht.

Bei der Get Severe Weather Alerts API handelt es sich um eine HTTP-Anforderung GET , die die Unwetterwarnungen zurückgibt, die weltweit sowohl von offiziellen staatlichen Wetterbehörden als auch von führenden globalen bis regionalen Wetterwarnanbietern verfügbar sind. Der Dienst kann Details wie Alarmtyp, Kategorie, Stufe und detaillierte Beschreibung der aktiven schweren Warnungen für den angeforderten Standort zurückgeben, z. B. Hurrikane, Gewitter, Blitzschlag, Hitzewellen oder Waldbrände. Weitere Informationen finden Sie unter Anfordern von Unwetterwarnungen

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-Parameter

Anforderungsheader

Antworten

Sicherheit

AadToken

Dies sind die Microsoft Entra OAuth 2.0 Flows. In Kombination mit Azure rollenbasierten Zugriffs Steuerung kann sie verwendet werden, um den Zugriff auf Azure Maps REST-APIs zu steuern. Azure-rollenbasierte Zugriffskontrollen werden verwendet, um den Zugriff auf ein oder mehrere Azure Maps-Ressourcenkonten oder -Unterressourcen zu bestimmen. Jedem Benutzer, Gruppen- oder Dienstprinzipal kann über eine integrierte Rolle oder eine benutzerdefinierte Rolle, die aus einer oder mehreren Berechtigungen für Azure Maps-REST-APIs besteht, Zugriff gewährt werden.

Um Szenarien zu implementieren, empfehlen wir, Authentifizierungskonzepteanzuzeigen. Zusammenfassend bietet diese Sicherheitsdefinition eine Lösung für die Modellierung von Anwendungen über Objekte, die zugriffsfähig für bestimmte APIs und Bereiche sind.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

subscription-key

Dies ist ein freigegebener Schlüssel, der bereitgestellt wird, wenn Sie Erstellen eines Azure Maps-Kontos im Azure-Portal oder mithilfe von PowerShell, CLI, Azure SDKs oder REST-API.

Mit diesem Schlüssel kann jede Anwendung auf alle REST-API zugreifen. Mit anderen Worten, dieser Schlüssel kann als Hauptschlüssel in dem Konto verwendet werden, in dem sie ausgestellt werden.

Für öffentlich zugängliche Anwendungen empfiehlt es sich, die vertraulichen Clientanwendungen Ansatz für den Zugriff auf Azure Maps-REST-APIs zu verwenden, damit Ihr Schlüssel sicher gespeichert werden kann.

Typ: apiKey
In: header

SAS Token

Dies ist ein Freigegebenes Zugriffssignaturtoken wird aus dem Listen-SAS-Vorgang auf der Azure Maps-Ressource über die Azure-Verwaltungsebene über das Azure-Portal, PowerShell, CLI, Azure SDKs oder REST-APIs erstellt.

Mit diesem Token ist jede Anwendung für den Zugriff mit rollenbasierten Azure-Zugriffssteuerungen und feinkörniger Kontrolle auf den Ablauf, die Rate und die Region(en) der Verwendung für das jeweilige Token autorisiert. Mit anderen Worten, das SAS-Token kann verwendet werden, um Anwendungen das Steuern des Zugriffs auf eine sicherere Weise zu ermöglichen als der freigegebene Schlüssel.

Für öffentlich zugängliche Anwendungen empfiehlt es sich, eine bestimmte Liste der zulässigen Ursprünge auf der Zuordnungskontoressource zu konfigurieren,, um das Rendern von Missbrauch zu begrenzen und das SAS-Token regelmäßig zu erneuern.

Typ: apiKey
In: header

Beispiele

Successfully retrieve severe weather alerts

GET https://atlas.microsoft.com/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
    }
  ]
}

Definitionen

AlertArea

Ein geografisches Gebiet, das von einer Unwetterwarnung abgedeckt wurde, wurde als Eintrag in SevereWeatherAlert.alertAreas. Jede AlertArea identifiziert das betroffene Gebiet durch name, gibt die Anfangs- und Endzeiten an, während der die Warnung dort gilt (startTime, endTime), meldet den aktuellsten Status der Warnung in diesem Gebiet (latestStatus), und enthält eine kurze Anzeige der Warnung summary . Wenn die Anfrage nach vollständigen Details fragt, wird auch der vollständige Alarmtext in alertDetails, mit alertDetailsLanguageCode der angegebenen Sprache zurückgegeben.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Übliche Fehlerantwort für alle Azure Resource Manager APIs, um Fehlerdetails bei fehlgeschlagenen Operationen zurückzugeben. (Dies folgt auch dem OData-Fehlerantwortformat.)

JsonFormat

Gewünschtes Format der Antwort. Nur json Format wird unterstützt.

LatestStatus

Der jüngste Status einer Unwetterwarnung in einem bestimmten Gebiet kehrte am AlertArea.latestStatus. Das gleiche Status-Schlüsselwort (eines von New, Continue, Update, Correct, Extend, Upgrade, , Cancel, oder Expire – siehe LatestStatusKeyword vollständige Liste) wird zweimal zurückgegeben: einmal in die auf der Anfrage angegebene Sprache übersetztlocalized (), und einmal auf Englisch (english), sodass Anrufer Endnutzern ein lokalisiertes Label anzeigen können, während dennoch ein stabiler, sprachunabhängiger Wert für das Einschalten des Status erhalten bleibt.

LatestStatusKeyword

Eine vordefinierte Liste von acht Schlüsselwörtern, die verwendet werden, um den aktuellen Status einer Unwetterwarnung zu beschreiben.

SevereWeatherAlert

Eine an der angegebenen Stelle aktive Unwetterwarnung wurde als Eintrag in SevereWeatherAlertsResult.results. Kombiniert Metadaten über die Warnung selbst (Land, Kennung, Kategorie, Schweregradklassifikation, Priorität, Ausgabequelle und etwaige Haftungsausschluss) mit kurzen, lokalisierten description und englischen Zusammenfassungsphrasen sowie einem alertAreas Array, das die spezifischen geografischen Gebiete der Warnung, die Wirksamkeitszeiten und die vollständigen Details zur Warnung beschreiben. Die zugrunde liegenden Warnungen werden von offiziellen staatlichen meteorologischen Behörden und führenden globalen Wetterwarnanbietern herausgegeben und umfassen Phänomene wie Hurrikane, Gewitter, Überschwemmungen, Blitze, Hitzewellen und Waldbrände.

SevereWeatherAlertDescription

Kurze Zusammenfassungssätze für eine Unwetterwarnung, zurückgegeben am .SevereWeatherAlert.description Derselbe Ausdruck wird zweimal verwendet: einmal in die auf der Anfrage angegebene Sprache übersetzt (localized) und einmal auf Englisch (english), sodass Anrufer Endnutzern ein lokalisiertes Label anzeigen können, während dennoch eine stabile, sprachunabhängige Zeichenkette für Protokollierung, Abgleich oder Fallback-Anzeige beibehalten bleibt.

SevereWeatherAlertsResult

Die Reaktion erfolgte durch die Get Severe Weather Alerts-Operation, die alle an der angegebenen Stelle aktiven Unwetterwarnungen enthielt. Warnungen beziehen sich auf Phänomene wie Hurrikane, Gewitter, Überschwemmungen, Blitze, Hitzewellen und Waldbrände – egal, was die örtlichen meteorologischen Behörden herausgegeben haben. Das Array results ist leer, wenn keine Alarme aktiviert sind.