Weather - Get Severe Weather Alerts
Umožňuje získat informace o nepříznivých povětrnostních podmínkách, jako jsou hurikány, bouřky, záplavy, blesky, vlny veder nebo lesní požáry pro danou lokalitu.
Nepříznivý jev počasí může výrazně ovlivnit náš každodenní život a obchodní provoz. Například nepříznivé povětrnostní podmínky, jako jsou tropické bouře, silné větry nebo záplavy, mohou uzavřít silnice a donutit logistické společnosti, aby přepojily své vozové parky, což způsobí zpoždění při připlutí do destinací a přerušení studeného řetězce chladicích potravin.
Rozhraní Get Severe Weather Alerts
API je požadavek HTTP GET
, který vrací výstrahy před nepříznivým počasím, které jsou k dispozici po celém světě jak od oficiálních vládních meteorologických agentur, tak od předních globálních až regionálních poskytovatelů meteorologických výstrah. Služba může vrátit podrobnosti, jako je typ výstrahy, kategorie, úroveň a podrobný popis aktivních závažných výstrah pro požadované místo, jako jsou hurikány, bouřky, blesky, vlny veder nebo lesní požáry. Další informace najdete v tématu Žádost o výstrahy před nepříznivým počasím.
GET https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query={query}
GET https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query={query}&language={language}&details={details}
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
format
|
path | True |
Požadovaný formát odpovědi. Podporuje se pouze |
|
api-version
|
query | True |
string |
Číslo verze rozhraní API Azure Maps. |
query
|
query | True |
number[] |
Příslušný dotaz zadaný jako řetězec oddělený čárkami složený podle zeměpisné šířky následované zeměpisnou délkou, např. "47.641268,-122.125679". |
details
|
query |
string |
Vraťte úplné podrobnosti o výstrahách před nepříznivým počasím. Dostupné hodnoty jsou
|
|
language
|
query |
string |
Jazyk, ve kterém se mají vracet výsledky hledání. Měl by být jednou z podporovaných značek jazyka IETF, nerozlišují se malá a velká písmena. Pokud data v zadaném jazyce nejsou pro konkrétní pole k dispozici, použije se výchozí jazyk. Podrobnosti najdete v části Podporované jazyky . |
Hlavička požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
x-ms-client-id |
string |
Určuje, který účet je určený pro použití ve spojení s modelem zabezpečení Microsoft Entra ID. Představuje jedinečné ID účtu Azure Maps a je možné ho načíst z rozhraní API účtu roviny správy Azure Maps. Pokud chcete použít Microsoft Entra ID zabezpečení v Azure Maps pokyny najdete v následujících článcích. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Došlo k neočekávané chybě. |
Zabezpečení
AADToken
Toto jsou Microsoft Entra toky OAuth 2.0. Při spárování s řízením přístupu na základě role v Azure se dá použít k řízení přístupu k Azure Maps rozhraní REST API. Řízení přístupu na základě role v Azure slouží k určení přístupu k jednomu nebo několika Azure Maps účtu prostředku nebo dílčím prostředkům. Každému uživateli, skupině nebo instančnímu objektu je možné udělit přístup prostřednictvím předdefinované role nebo vlastní role složené z jednoho nebo více oprávnění k Azure Maps rozhraní REST API.
Pokud chcete implementovat scénáře, doporučujeme zobrazit si koncepty ověřování. Souhrnně řečeno, tato definice zabezpečení poskytuje řešení pro modelování aplikací prostřednictvím objektů schopných řízení přístupu pro konkrétní rozhraní API a obory.
Poznámky
- Tato definice zabezpečení vyžaduje použití hlavičky
x-ms-client-id
k označení Azure Maps prostředku, ke kterému aplikace žádá o přístup. Můžete ho získat z rozhraní MAPS MANAGEMENT API.
Je Authorization URL
specifický pro instanci veřejného cloudu Azure. Suverénní cloudy mají jedinečné autorizační adresy URL a konfigurace Microsoft Entra ID.
* Řízení přístupu na základě role v Azure se konfiguruje z roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.
* Použití sady AZURE MAPS Web SDK umožňuje nastavení aplikace na základě konfigurace pro více případů použití.
- Další informace o Microsoft identity platform najdete v přehledu Microsoft identity platform.
Type:
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
Jedná se o sdílený klíč, který se zřídí při Create účtu Azure Maps v Azure Portal nebo pomocí PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.
S tímto klíčem může každá aplikace přistupovat ke všem rozhraním REST API. Jinými slovy, tento klíč se dá použít jako hlavní klíč v účtu, ve kterému je vystavený.
U veřejně vystavených aplikací doporučujeme pro přístup k Azure Maps rozhraní REST API použít přístup k důvěrným klientským aplikacím, aby se váš klíč mohl bezpečně uložit.
Type:
apiKey
In:
query
SAS Token
Jedná se o token sdíleného přístupového podpisu, který se vytvoří z operace List SAS v Azure Maps prostředku prostřednictvím roviny správy Azure prostřednictvím Azure Portal, PowerShellu, rozhraní příkazového řádku, sad Azure SDK nebo rozhraní REST API.
S tímto tokenem má každá aplikace autorizaci pro přístup pomocí řízení přístupu na základě role v Azure a podrobnou kontrolu vypršení platnosti, četnosti a oblastí použití konkrétního tokenu. Jinými slovy, token SAS je možné použít k tomu, aby aplikace mohly řídit přístup zabezpečeným způsobem než sdílený klíč.
U veřejně vystavených aplikací doporučujeme nakonfigurovat konkrétní seznam povolených zdrojů v prostředku mapového účtu , aby se omezilo zneužití vykreslování a pravidelně obnovovali token SAS.
Type:
apiKey
In:
header
Příklady
Successfully retrieve severe weather alerts
Sample Request
GET https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query=48.057,-81.091
Sample Response
{
"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"
}
]
}
]
}
Definice
Name | Description |
---|---|
Alert |
Informace o výstrahě před nepříznivým počasím vydaném v postižených zónách Pokud je pro stejné umístění aktivních více výstrah, vrátí se výstrahy v rámci odpovědi rozhraní API v pořadí |
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě |
Error |
Chybová odpověď |
Json |
Požadovaný formát odpovědi Podporuje se pouze |
Latest |
Nejnovější stav výstrahy v aktuální oblasti. |
Latest |
Klíčové slovo pro nejnovější stav výstrahy. |
Severe |
Informace o výstrahě před nepříznivým počasím. |
Severe |
Popis výstrahy před nepříznivým počasím |
Severe |
Tento objekt se vrátí z úspěšného volání Get Severe Weather Alert. |
AlertArea
Informace o výstrahě před nepříznivým počasím vydaném v postižených zónách Pokud je pro stejné umístění aktivních více výstrah, vrátí se výstrahy v rámci odpovědi rozhraní API v pořadí priority
od, přičemž výstraha s nejvyšší prioritou se vrátí v horní části odpovědi.
Name | Typ | Description |
---|---|---|
alertDetails |
string |
Úplné podrobnosti související s výstrahou Vrátí se, pokud |
alertDetailsLanguageCode |
string |
Jazyk . |
endTime |
string |
Koncové datum a čas výstrahy ve formátu ISO 8601, například 2019-10-27T19:39:57-08:00. Pokud výstraha překročí více časových pásem, je vrácený čas v odpovědi místním časem požadovaného umístění souřadnic. |
latestStatus |
Nejnovější stav výstrahy v aktuální oblasti. |
|
name |
string |
Název oblasti, která je výstrahou ovlivněna. Požadované umístění spadá do oblasti výstrahy. |
startTime |
string |
Počáteční datum a čas výstrahy ve formátu ISO 8601, například 2019-10-27T19:39:57-08:00. Pokud výstraha překročí více časových pásem, je vrácený čas v odpovědi místním časem požadovaného umístění souřadnic. |
summary |
string |
Text se souhrnem výstrahy ve vrácené oblasti |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Typ další informace. |
ErrorDetail
Podrobnosti o chybě
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě. |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě. |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
JsonFormat
Požadovaný formát odpovědi Podporuje se pouze json
formát.
Name | Typ | Description |
---|---|---|
json |
string |
LatestStatus
Nejnovější stav výstrahy v aktuální oblasti.
Name | Typ | Description |
---|---|---|
english |
Klíčové slovo latest status pro výstrahu v angličtině (en-US). |
|
localized |
string |
Klíčové slovo nejnovějšího stavu pro výstrahu v zadaném jazyce. Ve výchozím nastavení je vrácena v angličtině (en-US). |
LatestStatusKeyword
Klíčové slovo pro nejnovější stav výstrahy.
Name | Typ | Description |
---|---|---|
Cancel |
string |
Zrušit – upozornění bylo zrušeno před původním časem vypršení platnosti. |
Continue |
string |
Pokračovat – výstraha se od počátečního vydání aktualizovala, ale nedošlo k žádným změnám |
Correct |
string |
"Opravit" – výstraha byla upravena tak, aby opravila předchozí chybu. |
Expire |
string |
Vypršení platnosti – platnost upozornění vypršela a už není aktivní. |
Extend |
string |
"Rozšířit" – výstraha se od počátečního vystavení prodloužila včas, v oblasti nebo obojím. |
New |
string |
"Nové" – stav výstrahy při počátečním vystavení. |
Update |
string |
Aktualizace – výstraha se aktualizovala od počátečního vystavení. |
Upgrade |
string |
Upgrade – výstraha se od počátečního vystavení upgradovala na vyšší třídu nebo kategorii. |
SevereWeatherAlert
Informace o výstrahě před nepříznivým počasím.
Name | Typ | Description |
---|---|---|
alertAreas |
Informace o výstraze specifické pro ovlivněné oblasti |
|
alertId |
integer |
Jedinečný číselný identifikátor pro výstrahu o počasí. |
category |
string |
Kategorie výstrahy |
class |
string |
Klasifikace výstrahy. Toto pole není k dispozici pro všechny země, a proto není vždy vráceno. |
countryCode |
string |
2znakový kód země iso 3166-1 Alpha-2, například "US". |
description |
Popis výstrahy |
|
disclaimer |
string |
Právní omezení týkající se zdroje informací o upozornění. Toto pole není vždy k dispozici. Právní omezení může například obsahovat podrobnosti o zpožděních nebo potenciálních problémech souvisejících s alarmem. |
level |
string |
Úroveň závažnosti výstrahy. Toto pole není k dispozici pro všechny země, a proto není vždy vráceno. |
priority |
integer |
Číslo, které označuje důležitost nebo pořadí pořadí dané výstrahy v zemi nebo oblasti, ze které pochází. Nižší číslo znamená vyšší prioritu. Například 1 má nejvyšší prioritu. Počet se liší podle země/oblasti a může se v průběhu času měnit podle toho, jak se jednotlivé země/oblasti vyvíjejí jejich systémy upozornění. |
source |
string |
Poskytovatel informací o upozornění. Ve výchozím nastavení se zdroj vrátí v angličtině (en-US). Výstrahy jsou od oficiálních vládních meteorologických agentur a předních globálních poskytovatelů meteorologických výstrah. |
sourceId |
integer |
Číselný identifikátor přidružený k názvu poskytovatele zdroje dat výstrahy. |
SevereWeatherAlertDescription
Popis výstrahy před nepříznivým počasím
Name | Typ | Description |
---|---|---|
english |
string |
Popis výstrahy v angličtině (en-US) |
localized |
string |
Popis výstrahy v zadaném jazyce Ve výchozím nastavení se vrátí angličtina (en-US), pokud v požadavku není zadaný parametr jazyka. |
SevereWeatherAlertsResult
Tento objekt se vrátí z úspěšného volání Get Severe Weather Alert.
Name | Typ | Description |
---|---|---|
results |
Seznam všech výstrah před nepříznivým počasím pro dotazovanou polohu. |