Weather - Get Severe Weather Alerts

Służy do uzyskiwania informacji o trudnych warunkach pogodowych, takich jak huragany, burze, powodzie, pioruny, fale upałów lub pożary lasów w danej lokalizacji.
Gwałtowne zjawiska pogodowe mogą znacząco wpłynąć na nasze codzienne życie i działalność biznesową. Na przykład trudne warunki pogodowe, takie jak burze tropikalne, silne wiatry lub powodzie, mogą spowodować zamknięcie dróg i zmuszenie firm logistycznych do przekierowania floty, powodując opóźnienia w dotarciu do miejsc docelowych i przerwanie łańcucha chłodniczego chłodzonych produktów spożywczych.

Interfejs Get Severe Weather Alerts API to żądanie HTTP GET , które zwraca alerty o trudnych warunkach pogodowych, które są dostępne na całym świecie zarówno przez oficjalne rządowe agencje meteorologiczne, jak i wiodących globalnych i regionalnych dostawców alertów pogodowych. Usługa może zwracać szczegółowe informacje, takie jak typ alertu, kategoria, poziom i szczegółowy opis aktywnych poważnych alertów dla żądanej lokalizacji, takich jak huragany, burze, pioruny, fale upałów lub pożary lasów. Aby uzyskać więcej informacji, zobacz Żądanie alertów o trudnych warunkach pogodowych

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}

Parametry identyfikatora URI

Nagłówek żądania

Odpowiedzi

Zabezpieczenia

AadToken

Są to przepływy Microsoft Entra OAuth 2.0. W połączeniu z Azure zarządzaniem dostępem opartym na rolach może być używany do kontroli dostępu do Azure Maps API REST. Kontrola dostępu oparta na rolach Azure służy do wyznaczania dostępu do jednego lub więcej kont zasobów lub podzasobów Azure Maps. Każdy użytkownik, grupa lub jednostka usługi mogą mieć dostęp za pośrednictwem wbudowanej roli lub roli niestandardowej składającej się z co najmniej jednego uprawnienia do interfejsów API REST usługi Azure Maps.

Aby zaimplementować scenariusze, zalecamy wyświetlenie koncepcji uwierzytelniania . Podsumowując, ta definicja zabezpieczeń zawiera rozwiązanie do modelowania aplikacji za pośrednictwem obiektów, które mogą kontrolować dostęp do określonych interfejsów API i zakresów.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

subscription-key

Jest to klucz wspólny aprowizowany podczas tworzenie konta usługi Azure Maps w witrynie Azure Portal lub przy użyciu programu PowerShell, interfejsu wiersza polecenia, zestawów SDK platformy Azure lub interfejsu API REST.

Za pomocą tego klucza każda aplikacja może uzyskiwać dostęp do całego interfejsu API REST. Innymi słowy, ten klucz może służyć jako klucz główny na koncie, w którym są wystawiane.

W przypadku publicznie uwidocznionych aplikacji zalecamy użycie poufnych aplikacji klienckich podejście do uzyskiwania dostępu do interfejsów API REST usługi Azure Maps, aby klucz mógł być bezpiecznie przechowywany.

Typ: apiKey
W: header

SAS Token

Jest to token sygnatury dostępu współdzielonego tworzony na podstawie operacji List SAS na zasobie usługi Azure Maps za pośrednictwem płaszczyzny zarządzania platformy Azure za pośrednictwem witryny Azure Portal, programu PowerShell, interfejsu wiersza polecenia, zestawów AZURE SDK lub interfejsów API REST.

Dzięki temu tokenowi każda aplikacja jest autoryzowana do uzyskiwania dostępu za pomocą kontroli dostępu opartej na rolach platformy Azure i szczegółowej kontroli wygaśnięcia, szybkości i regionów użycia dla określonego tokenu. Innymi słowy, token SAS może służyć do umożliwienia aplikacjom kontrolowania dostępu w sposób bardziej zabezpieczony niż klucz wspólny.

W przypadku publicznie uwidocznionych aplikacji zalecamy skonfigurowanie określonej listy dozwolonych źródeł w zasobie Mapowanie konta w celu ograniczenia nadużyć renderowania i regularnego odnawiania tokenu SAS.

Typ: apiKey
W: header

Przykłady

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
    }
  ]
}

Definicje

AlertArea

Jeden obszar geograficzny objęty alertem o silnej pogodzie zwrócił się jako wpis w SevereWeatherAlert.alertAreas. Każdy z nich AlertArea identyfikuje dotknięty obszar przez , nameco podaje czasy rozpoczęcia i zakończenia działania alertu (startTime, ), endTimeraportuje najnowszy status alertu w tym obszarze (latestStatus), oraz zawiera krótki obraz summary alertu. Gdy żądanie wymaga podania pełnych szczegółów, pełny tekst alertu również jest zwracany w , alertDetailsz alertDetailsLanguageCode określeniem języka, w którym został dostarczony.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Wspólna odpowiedź na błędy dla wszystkich API Azure Resource Manager zwraca szczegóły błędów dla nieudanych operacji. (Jest to również zgodne z formatem odpowiedzi na błąd OData).

JsonFormat

Żądany format odpowiedzi. Obsługiwany jest tylko format json.

LatestStatus

Ostatni status ostrzeżenia o gwałtownej pogodzie w określonym rejonie powrócił na AlertArea.latestStatus. To samo słowo kluczowe statusowe (jedno z New, Continue, Update, Correct, Extend, Upgrade, Cancel, lub Expire – zobacz LatestStatusKeyword pełną listę) jest zwracane dwukrotnie: raz przetłumaczone na język określony w żądaniu (localized), oraz raz na angielski (english), dzięki czemu wywołujący mogą wyświetlać użytkownikom końcowym lokalizowaną etykietę, zachowując stabilną, niezależną od języka wartość statusu włączania.

LatestStatusKeyword

Predefiniowana lista ośmiu słów kluczowych używanych do opisania bieżącego stanu alertu pogodowego.

SevereWeatherAlert

Jeden alert o silnej pogodzie aktywny w wskazanym miejscu, zwrócony jako wpis w SevereWeatherAlertsResult.results. Łączy metadane dotyczące samego alertu (kraj, identyfikator, kategoria, klasyfikacja nasilenia, priorytet, źródło wydania oraz wszelkie zastrzeżenia) z description krótkimi, lokalnymi i angielskimi frazami streszczającymi oraz tablicą alertAreas opisującą konkretne obszary geograficzne, które obejmuje alert, czasy jego działania oraz pełne szczegóły alertu. Podstawowe alerty są wydawane przez oficjalne rządowe agencje meteorologiczne oraz czołowych globalnych dostawców alertów pogodowych i obejmują zjawiska takie jak huragany, burze, powodzie, pioruny, fale upałów i pożary lasów.

SevereWeatherAlertDescription

Krótkie podsumowania dotyczące alertu o gwałtownej pogodzie, zwrócone w .SevereWeatherAlert.description Ta sama fraza jest podawana dwukrotnie: raz przetłumaczona na język określony w żądaniu (localized) i raz na angielski (english), dzięki czemu wywołujący mogą wyświetlać użytkownikom końcowym lokalizowaną etykietę, zachowując jednocześnie stabilny, niezależny od języka ciąg do logowania, dopasowywania lub wyświetlania zapasowego.

SevereWeatherAlertsResult

Odpowiedź powróciła w formie operacji Get Severe Weather Alerts, zawierającej wszystkie aktywne alerty o gwałtownej pogodzie w podanej lokalizacji. Alerty obejmują zjawiska takie jak huragany, burze, powodzie, pioruny, fale upałów i pożary lasów – wszystko, co lokalne władze meteorologiczne wydały. Tablica results jest pusta, gdy nie działają żadne alerty.