Weather - Get Severe Weather Alerts

Referencia

Szolgáltatás:: Maps

API-verzió:: 1.1

Segítségével információt kaphat a súlyos időjárási körülményekről, például hurrikánokról, zivatarokról, árvízről, villámlásról, hőhullámokról vagy erdőtüzekről egy adott helyen.

A súlyos időjárási jelenségek jelentősen befolyásolhatják mindennapi életünket és üzleti tevékenységeinket. Például a súlyos időjárási körülmények, például a trópusi viharok, a nagy szél vagy az áradás bezárhatják az utakat, és kényszeríthetik a logisztikai vállalatokat, hogy átirányítsák flottájukat, ami késéseket okoz a célállomások elérésében és a hűtőélelmiszerek hűtőláncának megszakításában.

Az Get Severe Weather Alerts API egy HTTP-kérés GET , amely visszaadja azokat a súlyos időjárási riasztásokat, amelyek világszerte elérhetők a hivatalos kormányzati meteorológiai ügynökségektől, és globálisan vezetnek a regionális időjárási riasztások szolgáltatóihoz. A szolgáltatás olyan adatokat adhat vissza, mint a riasztás típusa, kategóriája, szintje és részletes leírása a kért helyre vonatkozó aktív súlyos riasztásokról, például hurrikánokról, zivatarokról, villámokról, hőhullámokról vagy erdőtüzekről. További információ: Súlyos időjárási riasztások kérése

GET https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query={query}

Opcionális paraméterekkel:

GET https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query={query}&language={language}&details={details}

URI-paraméterek

Name	In	Kötelező	Típus	Description
format	path	True	JsonFormat	A válasz kívánt formátuma. Csak `json` a formátum támogatott.
api-version	query	True	string	Az Azure Maps API verziószáma.
query	query	True	number[]	A megfelelő lekérdezés, amelyet vesszővel tagolt sztringként határoz meg, amelyet szélesség és hosszúság követ, például:"47.641268,-122.125679".
details	query		string	Adja vissza a súlyos időjárási riasztások részletes adatait. A rendelkezésre álló értékek a következők: `true` – A teljes részleteket adja vissza. Alapértelmezés szerint a rendszer minden adatot visszaad. `false` – A riasztási adatok csonkolt verzióját adja vissza, amely kizárja a riasztás részleteinek területspecifikus teljes leírását (`alertDetails`).
language	query		string	Az a nyelv, amelyben a keresési eredményeket vissza kell adni. A támogatott IETF nyelvcímkék egyikének kell lennie, a kis- és nagybetűk nem különböztethetők meg. Ha a megadott nyelvű adatok nem érhetők el egy adott mezőhöz, a rendszer az alapértelmezett nyelvet használja. Részletekért tekintse meg a támogatott nyelveket ismertető cikket.

Kérelem fejléce

Name	Kötelező	Típus	Description
x-ms-client-id		string	Meghatározza, hogy melyik fiók legyen használatban a Microsoft Entra ID biztonsági modellel együtt. Az Azure Maps-fiók egyedi azonosítóját jelöli, és lekérhető az Azure Maps felügyeleti síkjának Fiók API-jából. A Microsoft Entra ID-biztonság Azure Mapsben való használatához tekintse meg az alábbi cikkeket .

Válaszok

Name	Típus	Description
200 OK	SevereWeatherAlertsResult	OKÉ
Other Status Codes	ErrorResponse	Váratlan hiba történt.

Biztonság

AADToken

Ezek a Microsoft Entra OAuth 2.0 folyamatok. Az Azure-beli szerepköralapú hozzáférés-vezérléssel párosítva szabályozható az Azure Maps REST API-khoz való hozzáférés. Az Azure szerepköralapú hozzáférés-vezérlői egy vagy több Azure Maps-erőforrásfiókhoz vagy alerőforrásokhoz való hozzáférés kijelölésére szolgálnak. Bármely felhasználó, csoport vagy szolgáltatásnév hozzáférést kaphat egy beépített szerepkörrel, vagy egy vagy több Azure Maps REST API-ra vonatkozó engedélyből álló egyéni szerepkörrel.

A forgatókönyvek implementálásához javasoljuk, hogy tekintse meg a hitelesítési fogalmakat. Összefoglalva, ez a biztonsági definíció megoldást nyújt az alkalmazások modellezésére olyan objektumokon keresztül, amelyek hozzáférés-vezérlésre képesek adott API-kon és hatókörökön.

Jegyzetek

Ez a biztonsági definíció megköveteli a fejléc használatát x-ms-client-id annak jelzéséhez, hogy az alkalmazás melyik Azure Maps-erőforráshoz kér hozzáférést. Ez a Térképek felügyeleti API-ból szerezhető be.

Ez Authorization URL az Azure nyilvános felhőpéldányára jellemző. A szuverén felhők egyedi engedélyezési URL-címekkel és Microsoft Entra ID-konfigurációkkal rendelkeznek. * Az Azure szerepköralapú hozzáférés-vezérlés az Azure felügyeleti síkjáról van konfigurálva az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy a REST API-kon keresztül. * Az Azure Maps Web SDK használata lehetővé teszi egy alkalmazás konfigurációalapú beállítását több használati esetben.

A Microsoft identitásplatformról további információt a Microsoft identitásplatform áttekintése című témakörben talál.

Típus: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Ez egy megosztott kulcs, amely akkor lesz kiépítve, ha Azure Maps-fiókot hoz létre az Azure Portalon, vagy a PowerShell, a CLI, az Azure SDK-k vagy a REST API használatával.

Ezzel a kulccsal bármely alkalmazás hozzáférhet az összes REST API-hoz. Más szóval ez a kulcs használható főkulcsként abban a fiókban, amelyben ki vannak adva.

Nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy a bizalmas ügyfélalkalmazások megközelítésével érje el az Azure Maps REST API-kat, hogy a kulcs biztonságosan tárolható legyen.

Típus: apiKey
In: query

SAS Token

Ez egy közös hozzáférésű jogosultságkód-jogkivonat az Azure Maps-erőforrás Sas listázási műveletéből jön létre az Azure Felügyeleti síkon keresztül az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy a REST API-kon keresztül.

Ezzel a jogkivonattal minden alkalmazás jogosult hozzáférni az Azure szerepköralapú hozzáférés-vezérlőihez, valamint az adott jogkivonat lejáratához, sebességéhez és régiójához. Más szóval az SAS-jogkivonattal az alkalmazások biztonságosabb módon szabályozhatják a hozzáférést, mint a megosztott kulcs.

Nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy konfiguráljon egy adott listát az engedélyezett forrásokról a térképfiók-erőforráson a leképezési visszaélések korlátozásához és az SAS-jogkivonat rendszeres megújításához.

Típus: apiKey
In: header

Példák

Successfully retrieve severe weather alerts

Sample request

HTTP

GET https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query=48.057,-81.091

Sample response

Status code:: 200

{
  "results": [
    {
      "countryCode": "CA",
      "alertId": 242621,
      "description": {
        "localized": "Heat Warning",
        "english": "Heat Warning"
      },
      "category": "NON-PRECIPITATION",
      "priority": 31,
      "source": "Environment Canada",
      "sourceId": 3,
      "alertAreas": [
        {
          "name": "Kirkland Lake - Englehart",
          "summary": "Heat Warning in effect until Thursday, 3:16 AM EDT.  Source: Environment Canada",
          "startTime": "2020-06-29T19:44:00+00:00",
          "endTime": "2020-07-02T07:16:03+00:00",
          "latestStatus": {
            "localized": "Continue",
            "english": "Continue"
          },
          "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"
        }
      ]
    },
    {
      "countryCode": "CA",
      "alertId": 242633,
      "description": {
        "localized": "Heat Warning",
        "english": "Heat Warning"
      },
      "category": "NON-PRECIPITATION",
      "priority": 31,
      "source": "Environment Canada",
      "sourceId": 3,
      "alertAreas": [
        {
          "name": "Kirkland Lake - Englehart",
          "summary": "Heat Warning in effect until 9:25 PM EDT.  Source: Environment Canada",
          "startTime": "2020-07-01T09:25:59+00:00",
          "endTime": "2020-07-02T01:25:59+00:00",
          "latestStatus": {
            "localized": "New",
            "english": "New"
          },
          "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"
        }
      ]
    }
  ]
}

Definíciók

Name	Description
AlertArea	Az érintett területen(ok) belül kiadott súlyos időjárási riasztásra vonatkozó információk. Ha több riasztás is aktív ugyanahhoz a helyhez, a rendszer az API-válaszon belül sorrendben `priority` adja vissza a riasztásokat, a legmagasabb prioritású riasztás pedig a válasz tetején jelenik meg.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
JsonFormat	A válasz kívánt formátuma. Csak `json` a formátum támogatott.
LatestStatus	A riasztás legfrissebb állapota az aktuális területen.
LatestStatusKeyword	A riasztás legfrissebb állapotának kulcsszója.
SevereWeatherAlert	Információk a súlyos időjárási riasztásokról.
SevereWeatherAlertDescription	Súlyos időjárási riasztás leírása.
SevereWeatherAlertsResult	Ezt az objektumot egy sikeres, Súlyos időjárási riasztások lekérése hívás adja vissza.

AlertArea

Az érintett területen(ok) belül kiadott súlyos időjárási riasztásra vonatkozó információk. Ha több riasztás is aktív ugyanahhoz a helyhez, a rendszer az API-válaszon belül sorrendben priority adja vissza a riasztásokat, a legmagasabb prioritású riasztás pedig a válasz tetején jelenik meg.

Name	Típus	Description
alertDetails	string	A riasztáshoz társított teljes részletek. `details`Ha =Igaz értéket ad vissza. Ezt a mezőt mindig a kibocsátó szolgáltató által választott nyelven adja vissza, az Azure Maps pedig csak azt adja vissza, amit a szolgáltató hozott létre. Felhívjuk figyelmét, hogy egyes országok/régiók kínálhatják anyanyelvüket és angol nyelvüket. A nyelvi paraméter erre a mezőre nem vonatkozik.
alertDetailsLanguageCode	string	A nyelvének `alertDetails`nyelve. Ez a mező segít rámutatni arra, hogy a nyelv `alertDetails` eltérhet a kért nyelvi paramétertől. `details`Ha =Igaz értéket ad vissza. A nyelvi kód az ISO 639-1 Alpha-2 kódokból származik.
endTime	string	A riasztás záró dátuma és időpontja ISO 8601 formátumban, például 2019-10-27T19:39:57-08:00. Ha a riasztás több időzónát is átlép, a válaszban visszaadott idő a kért koordináta-helyre való helyi idő.
latestStatus	LatestStatus	A riasztás legfrissebb állapota az aktuális területen.
name	string	A riasztás által érintett terület neve. A kért hely a riasztási terület alá tartozik.
startTime	string	A riasztás kezdő dátuma és időpontja ISO 8601 formátumban, például 2019-10-27T19:39:57-08:00. Ha a riasztás több időzónát is átlép, a válaszban visszaadott idő a kért koordináta-helyre való helyi idő.
summary	string	A riasztást összegző szöveg a visszaadott területen.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

JsonFormat

A válasz kívánt formátuma. Csak json a formátum támogatott.

Name	Típus	Description
json	string	A JavaScript-objektum jelölési adatcseréjének formátuma

LatestStatus

A riasztás legfrissebb állapota az aktuális területen.

Name	Típus	Description
english	LatestStatusKeyword	A riasztás legfrissebb állapot kulcsszója angol nyelven (en-US).
localized	string	A riasztás legújabb állapotszava a megadott nyelven. Alapértelmezés szerint angolul (en-US) adja vissza.

LatestStatusKeyword

A riasztás legfrissebb állapotának kulcsszója.

Name	Típus	Description
Cancel	string	"Mégse" – a riasztást az eredeti lejárati idő előtt törölték.
Continue	string	"Folytatás" – a riasztás a kezdeti kiállítása óta frissült, de nem történt módosítás a , `startTime`, vagy .`alertDetailsendTimeclass`
Correct	string	"Helyes" – a riasztás egy korábbi hiba kijavítása érdekében módosult.
Expire	string	"Lejárat" – a riasztás lejárt, és már nem aktív.
Extend	string	"Kiterjesztve" – a riasztást a kezdeti kiállítás óta hosszabbították meg időben, a területen vagy mindkettőben.
New	string	"Új" – a riasztás állapota a kezdeti kiadáskor.
Update	string	"Frissítés" – a riasztás a kezdeti kiadás óta frissült.
Upgrade	string	"Frissítés" – a riasztás a kezdeti kiadás óta magasabb osztályra vagy kategóriára lett frissítve.

SevereWeatherAlert

Információk a súlyos időjárási riasztásokról.

Name	Típus	Description
alertAreas	AlertArea[]	Az érintett terület(ek)hez tartozó riasztásra vonatkozó információk.
alertId	integer	Egy időjárási riasztás egyedi numerikus azonosítója.
category	string	A riasztás kategóriája.
class	string	A riasztás besorolása. Ez a mező nem minden országban érhető el, ezért nem mindig adja vissza.
countryCode	string	2 karakteres ISO 3166-1 Alpha-2 országkód, például "USA".
description	SevereWeatherAlertDescription	A riasztás leírása.
disclaimer	string	A riasztási információk forrásával kapcsolatos jogi nyilatkozat. Ez a mező nem mindig érhető el. A felelősségkizárás például tartalmazhat részleteket a riasztással kapcsolatos késésekről vagy esetleges problémákról.
level	string	A riasztás súlyossági szintje. Ez a mező nem minden országban érhető el, ezért nem mindig adja vissza.
priority	integer	Az adott riasztás fontosságát vagy rangsorolási sorrendjét jelző szám az eredeti országon/régión belül. Az alacsonyabb szám magasabb prioritást jelez. Például az 1 a legmagasabb prioritás. A szám országonként/régiónként változik, és idővel változhat, ahogy az egyes országok/régiók fejlesztik a riasztási rendszerüket.
source	string	A riasztási adatok szolgáltatója. Alapértelmezés szerint a forrás angolul (en-US) lesz visszaadva. A riasztások hivatalos kormányzati meteorológiai ügynökségektől és vezető globális időjárási riasztásszolgáltatóktól származnak.
sourceId	integer	A riasztási adatok forrásszolgáltatójának nevéhez társított numerikus azonosító.

SevereWeatherAlertDescription

Súlyos időjárási riasztás leírása.

Name	Típus	Description
english	string	A riasztás leírása angol nyelven (en-US).
localized	string	A riasztás leírása a megadott nyelven. Alapértelmezés szerint az angol (en-US) lesz visszaadva, ha a nyelvi paraméter nincs megadva a kérelemben.

SevereWeatherAlertsResult

Ezt az objektumot egy sikeres, Súlyos időjárási riasztások lekérése hívás adja vissza.

Name	Típus	Description
results	SevereWeatherAlert[]	A lekérdezett helyre vonatkozó összes súlyos időjárási riasztás listája.

Megosztás a következőn keresztül: