Weather - Get Severe Weather Alerts
Permet d’obtenir des informations sur les conditions météorologiques extrêmes telles que les ouragans, les orages, les inondations, la foudre, les vagues de chaleur ou les incendies de forêt pour un endroit donné.
Les phénomènes météorologiques violents peuvent avoir un impact significatif sur notre vie quotidienne et nos activités commerciales. Par exemple, des conditions météorologiques extrêmes telles que des tempêtes tropicales, des vents violents ou des inondations peuvent fermer des routes et obliger les entreprises de logistique à réacheminer leur flotte, ce qui entraîne des retards dans l’atteinte des destinations et rompt la chaîne du froid des produits alimentaires réfrigérés.
L’API Get Severe Weather Alerts est une requête HTTP GET qui renvoie les alertes de temps violent disponibles dans le monde entier auprès des agences météorologiques gouvernementales officielles et des principaux fournisseurs d’alertes météorologiques mondiales et régionales. Le service peut renvoyer des détails tels que le type d’alerte, la catégorie, le niveau et une description détaillée des alertes graves actives pour l’emplacement demandé, comme les ouragans, les orages, la foudre, les vagues de chaleur ou les incendies de forêt. Pour plus d’informations, consultez la section Demander des alertes de temps violent
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}
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
Le nom d’hôte du service Azure Maps. Utilisez |
|
format
|
path | True |
Format souhaité de la réponse. Seul |
|
|
api-version
|
query | True |
string minLength: 1 |
Version de l’API à utiliser pour cette opération. |
|
query
|
query | True |
number[] |
Requête applicable spécifiée en tant que chaîne séparée par des virgules composée par latitude suivie de longitude, par exemple « 47,641268,-1222.125679 ». Les informations météorologiques sont généralement disponibles pour les emplacements sur terre, les plans d’eau entourés de terre et les zones de l’océan qui se trouvent à environ 50 milles marins d’un littoral. |
|
details
|
query |
string |
Retournez tous les détails pour les alertes de temps violent. Les valeurs disponibles sont
|
|
|
language
|
query |
string |
Langue dans laquelle les résultats de recherche doivent être retournés. Doit être l’une des balises de langage IETF prises en charge, sans respect de la casse. Lorsque les données dans la langue spécifiée ne sont pas disponibles pour un champ spécifique, la langue par défaut est utilisée. Pour plus d’informations, consultez langues prises en charge. |
En-tête de la demande
| Nom | Obligatoire | Type | Description |
|---|---|---|---|
| x-ms-client-id |
string |
Indique le compte destiné à être utilisé avec le modèle de sécurité Microsoft Entra ID. Cet ID unique pour le compte Azure Maps peut être obtenu depuis l’API de compte Azure Maps plan de gestion. Pour plus d’informations sur l’utilisation de la sécurité Microsoft Entra ID dans Azure Maps, voir Gérer l’authentification dans Azure Maps. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
La demande a réussi. |
|
| Other Status Codes |
Réponse d’erreur inattendue. |
Sécurité
AadToken
Ce sont les flux Microsoft Entra OAuth 2.0. Lorsqu’il est associé au contrôle d’accès basé sur Azure par rôle, il peut être utilisé pour contrôler l’accès à Azure Maps API REST. Les contrôles d’accès basés sur les rôles Azure sont utilisés pour désigner l’accès à un ou plusieurs comptes ou sous-ressources de ressources Azure Maps. Tout utilisateur, groupe ou principal de service peut avoir accès via un rôle intégré ou un rôle personnalisé composé d’une ou plusieurs autorisations pour les API REST Azure Maps.
Pour implémenter des scénarios, nous vous recommandons d’afficher concepts d’authentification. En résumé, cette définition de sécurité fournit une solution pour la modélisation des applications via des objets capables de contrôler l’accès sur des API et des étendues spécifiques.
Note
- Cette définition de sécurité nécessite l’utilisation de l’en-tête
x-ms-client-idpour indiquer la ressource Azure Maps à laquelle l’application demande l’accès. Cela peut être acquis à partir de l’API de gestion Maps. - La
Authorization URLest spécifique à l’instance de cloud public Azure. Les clouds souverains disposent d’URL d’autorisation uniques et de configurations d’identifiants Microsoft Entra ID. - Le contrôle d’accès en fonction du rôle Azure est configuré à partir de l'plan de gestion Azure via le portail Azure, PowerShell, l’interface CLI, les SDK Azure ou les API REST.
- L’utilisation du kit de développement logiciel (SDK) web Azure Maps permet la configuration basée sur la configuration d’une application pour plusieurs cas d’usage.
- Pour plus d’informations sur la plateforme d’identités Microsoft, consultez vue d’ensemble de la plateforme d’identités Microsoft.
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
| Nom | Description |
|---|---|
| https://atlas.microsoft.com/.default |
subscription-key
Il s’agit d’une clé partagée provisionnée lorsque vous créer un compte Azure Maps dans le portail Azure ou à l’aide de PowerShell, CLI, sdk Azure ou API REST.
Avec cette clé, toute application peut accéder à toutes les API REST. En d’autres termes, cette clé peut être utilisée comme clé principale dans le compte dans lequel elles sont émises.
Pour les applications exposées publiquement, nous vous recommandons d’utiliser les applications clientes confidentielles approche permettant d’accéder aux API REST Azure Maps afin que votre clé puisse être stockée en toute sécurité.
Type:
apiKey
Dans:
header
SAS Token
Il s’agit d’un jeton de signature d’accès partagé créé à partir de l’opération List SAS sur la ressource Azure Maps via le plan de gestion Azure via le portail Azure, PowerShell, CLI, azure SDK ou LES API REST.
Avec ce jeton, toute application est autorisée à accéder avec des contrôles d’accès en fonction du rôle Azure et un contrôle précis à l’expiration, au taux et aux régions d’utilisation pour le jeton particulier. En d’autres termes, le jeton SAP peut être utilisé pour permettre aux applications de contrôler l’accès de manière plus sécurisée que la clé partagée.
Pour les applications exposées publiquement, nous vous recommandons de configurer une liste spécifique d’origines autorisées sur la ressource de compte mapper pour limiter l’abus de rendu et renouveler régulièrement le jeton SAP.
Type:
apiKey
Dans:
header
Exemples
Successfully retrieve severe weather alerts
Exemple de requête
GET https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query=48.057,-81.091
Exemple de réponse
{
"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
}
]
}
Définitions
| Nom | Description |
|---|---|
|
Alert |
Une zone géographique couverte par une alerte météo sévère, renvoyée comme une entrée dans |
|
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
|
Error |
Détail de l’erreur. |
|
Error |
Réponse à l’erreur courante pour toutes les API Azure Resource Manager afin de renvoyer les détails d’erreur pour les opérations ratées. (Cela suit également le format de réponse d’erreur OData.). |
|
Json |
Format souhaité de la réponse. Seul |
|
Latest |
Le statut le plus récent d’une alerte météo sévère dans une zone spécifique, est revenu le |
|
Latest |
Une liste prédéfinie de huit mots-clés utilisés pour décrire l’état actuel d’une alerte de temps violent. |
|
Severe |
Une alerte météo sévère active à l’emplacement spécifié, renvoyée comme une entrée dans |
|
Severe |
Phrases résumées courtes pour une alerte météo sévère, retournées le |
|
Severe |
La réponse est revenue par l’opération Obtenir des alertes météorologiques sévères, contenant toutes les alertes météorologiques violentes actives à l’emplacement spécifié.
Les alertes couvrent des phénomènes tels que les ouragans, orages, inondations, éclairs, vagues de chaleur et incendies de forêt – quels que soient les états météorologiques locaux. Le |
AlertArea
Une zone géographique couverte par une alerte météo sévère, renvoyée comme une entrée dans SevereWeatherAlert.alertAreas. Chacun AlertArea identifie la zone affectée par name, indique les heures de début et de fin pendant lesquelles l’alerte est en vigueur à cet endroit (startTime, endTime), rapporte le statut le plus récent de l’alerte dans cette zone (latestStatus), et affiche un court affichage summary de l’alerte. Lorsque la demande demande tous les détails, le texte d’alerte complet est également retourné en alertDetails, en alertDetailsLanguageCode identifiant la langue dans laquelle il est fourni.
| Nom | Type | Description |
|---|---|---|
| alertDetails |
string |
Le texte d’alerte complet en format libre émis par la source pour cette zone, adapté à l’affichage de l’avis complet. Retourné seulement lorsque la demande demande tous les détails. Le texte est retourné dans la langue dans laquelle le fournisseur émetteur l’a fourni, ce qui peut différer de la langue demandée pour le reste de la réponse ; le compagnon |
| alertDetailsLanguageCode |
string |
La langue de |
| endTime |
string (date-time) |
La date et l’heure à laquelle l’alerte se termine ou prendra fin pour cette zone, au format RFC 3339 (yyy-mm-ddThh :mm :ss-hh:mm). Par exemple, 2025-04-29T07:00:00-07:00. Si l’alerte couvre plusieurs fuseaux horaires, la valeur reflète l’heure locale aux coordonnées fournies sur la demande. |
| latestStatus |
Le statut le plus récent de l’alerte dans cette zone (par exemple, si elle est récemment émise, en cours ou annulée).
Retourné à la fois comme une phrase localisée et une valeur indépendante |
|
| name |
string |
Le nom de la zone géographique affectée par l’alerte dans cette entrée - par exemple, Kirkland Lake - Englehart. Identifie la région ou la localité spécifique à laquelle s’appliquent les horaires, le statut et le texte détaillé de ce texte |
| startTime |
string (date-time) |
La date et l’heure de début de l’alerte pour cette zone, au format RFC 3339 (yyyy-mm-ddThh :mm :ss-hh:mm). Par exemple, 2025-04-29T07:00:00-07:00. Si l’alerte couvre plusieurs fuseaux horaires, la valeur reflète l’heure locale aux coordonnées fournies sur la demande. |
| summary |
string |
Un résumé bref et affichable de l’alerte pour cette zone, incluant la période pendant laquelle elle est en vigueur et la source émettrice. Par exemple, l’avertissement de chaleur est en vigueur jusqu’à jeudi, 3h16 EDT. Source : Environnement Canada. |
ErrorAdditionalInfo
Informations supplémentaires sur l’erreur de gestion des ressources.
| Nom | Type | Description |
|---|---|---|
| info |
Informations supplémentaires. |
|
| type |
string |
Type d’informations supplémentaire. |
ErrorDetail
Détail de l’erreur.
| Nom | Type | Description |
|---|---|---|
| additionalInfo |
Informations supplémentaires sur l’erreur. |
|
| code |
string |
Code d’erreur. |
| details |
Détails de l’erreur. |
|
| message |
string |
Message d’erreur. |
| target |
string |
Cible d’erreur. |
ErrorResponse
Réponse à l’erreur courante pour toutes les API Azure Resource Manager afin de renvoyer les détails d’erreur pour les opérations ratées. (Cela suit également le format de réponse d’erreur OData.).
| Nom | Type | Description |
|---|---|---|
| error |
Objet d’erreur. |
JsonFormat
Format souhaité de la réponse. Seul json format est pris en charge.
| Valeur | Description |
|---|---|
| json |
LatestStatus
Le statut le plus récent d’une alerte météo sévère dans une zone spécifique, est revenu le AlertArea.latestStatus. Le même mot-clé d’état (l’un des Newsuivants , Continue, Update, Correct, UpgradeExtend, , Cancel, ou Expire - voir LatestStatusKeyword la liste complète) est retourné deux fois : une fois traduit dans la langue spécifiée sur la requête (localized), et une fois en anglais (english), afin que les appelants puissent afficher une étiquette localisée aux utilisateurs finaux tout en conservant une valeur stable et indépendante de la langue pour activer le statut.
| Nom | Type | Description |
|---|---|---|
| english |
Le mot-clé statut en anglais (en-US) - l’une des valeurs définies par |
|
| localized |
string |
Le mot-clé d’état est traduit dans la langue spécifiée sur la requête – par exemple, Continu pour le français. Si aucune clause n’a été spécifiée sur la demande, cela correspond |
LatestStatusKeyword
Une liste prédéfinie de huit mots-clés utilisés pour décrire l’état actuel d’une alerte de temps violent.
| Valeur | Description |
|---|---|
| Cancel |
Indique que l’alerte a été annulée avant l’expiration prévue. |
| Continue |
Indique que l’alerte a été mise à jour depuis sa publication initiale, mais qu’aucune modification n’a été apportée à |
| Correct |
Indique que l’alerte a été modifiée pour corriger une erreur précédente. |
| Expire |
Indique que l’alerte a expiré et n’est plus active. |
| Extend |
Indique que la durée de l’alerte, sa zone ou les deux ont été prolongées depuis son émission initiale. |
| New |
L’état d’une alerte lors de sa première émission. |
| Update |
Indique que l’alerte a été modifiée depuis son émission initiale. |
| Upgrade |
Indique que l’alerte a été élevée à une classe ou à une catégorie supérieure depuis sa première émission. |
SevereWeatherAlert
Une alerte météo sévère active à l’emplacement spécifié, renvoyée comme une entrée dans SevereWeatherAlertsResult.results. Combine les métadonnées sur l’alerte elle-même (pays, identifiant, catégorie, classification de gravité, priorité, source d’émission et toute clause de non-responsabilité) avec une description courte synthèse localisée et en anglais et un alertAreas tableau décrivant les zones géographiques spécifiques couvertes par l’alerte, les périodes d’effet, ainsi que le détail complet de l’alerte. Les alertes sous-jacentes sont émises par les agences météorologiques gouvernementales officielles et les principaux fournisseurs mondiaux d’alertes météorologiques, et couvrent des phénomènes tels que les ouragans, orages, inondations, éclairs, vagues de chaleur et incendies de forêt.
| Nom | Type | Description |
|---|---|---|
| alertAreas |
Les zones géographiques couvertes par l’alerte. Chacune |
|
| alertId |
integer (int32) |
Un identifiant numérique pour l’alerte, unique au sein du fournisseur émettric. |
| category |
string |
Une étiquette courte, indépendante de la langue, classifiant l’alerte selon le phénomène météorologique auquel elle s’intéresse – par exemple, |
| class |
string |
Une classification spécifique au fournisseur de l’alerte (par exemple, une catégorie d’alerte ou un type d’alerte), lorsqu’une alerte est fournie par l’agence émettrice. Pas disponible dans tous les pays et peut être omis. |
| countryCode |
string |
Le code pays ISO 3166-1 Alpha-2 à 2 caractères pour le pays ou la région où l’alerte a été émise - par exemple, |
| description |
De courtes phrases résumées pour l’alerte (par exemple, Heat Warning ou Tornado Watch), renvoyées à la fois dans la langue spécifiée dans la demande ( |
|
| disclaimer |
string |
Un avertissement concernant les informations d’alerte provenant de la source – par exemple, une note concernant d’éventuels retards ou limitations de données. Si elle est présente, elle doit être affichée aux côtés de l’alerte. Pas toujours en retour. |
| level |
string |
Le niveau de gravité de l’alerte, lorsqu’elle est fournie par l’agence émettrice. L’ensemble exact de valeurs dépend du fournisseur. Pas disponible dans tous les pays et peut être omis. |
| priority |
integer (int32) |
L’importance de l’alerte dans son pays ou sa région d’origine, où 1 est la priorité la plus élevée et les chiffres plus élevés sont moins prioritaires. L’échelle exacte dépend de chaque fournisseur et peut évoluer au fil du temps à mesure que les systèmes d’alerte évoluent. |
| source |
string |
Le nom de l’agence qui a émis l’alerte – par exemple, Environnement Canada ou le Service météorologique national des États-Unis. Les alertes sont généralement émises par des agences météorologiques gouvernementales officielles ou par les principaux fournisseurs mondiaux d’alertes météorologiques. |
| sourceId |
integer (int32) |
Un identifiant numérique pour le fournisseur source qui s’associe à |
SevereWeatherAlertDescription
Phrases résumées courtes pour une alerte météo sévère, retournées le SevereWeatherAlert.description. La même phrase est fournie deux fois : une fois traduite dans la langue spécifiée sur la requête (localized) et une fois en anglais (english), afin que les appelants puissent afficher une étiquette localisée aux utilisateurs finaux tout en conservant une chaîne stable et indépendante de la langue pour l’enregistrement, le correspondance ou l’affichage de secours.
| Nom | Type | Description |
|---|---|---|
| english |
string |
La phrase résumée en anglais (en-US) - par exemple, Heat Warning ou Tornado Watch. Toujours retourné en anglais, quelle que soit la langue demandée, ce qui en fait une étiquette stable et indépendante de la langue. |
| localized |
string |
La phrase résumée traduite dans la langue spécifiée sur la demande (par exemple, Avis de chaleur pour le français). Si aucune clause n’a été spécifiée sur la demande, cela correspond |
SevereWeatherAlertsResult
La réponse est revenue par l’opération Obtenir des alertes météorologiques sévères, contenant toutes les alertes météorologiques violentes actives à l’emplacement spécifié.
Les alertes couvrent des phénomènes tels que les ouragans, orages, inondations, éclairs, vagues de chaleur et incendies de forêt – quels que soient les états météorologiques locaux. Le results tableau est vide lorsqu’aucune alerte n’est activée.
| Nom | Type | Description |
|---|---|---|
| results |
Les alertes météorologiques sévères actives à l’emplacement spécifié, classées par |