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 https://atlas.microsoft.com pour le Azure cloud public. Pour cibler une géographie Azure Maps spécifique ou un nuage souverain, voir Azure Maps portée géographique.

format
path True

JsonFormat

Format souhaité de la réponse. Seul json format est pris en charge.

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

  • true - Renvoie tous les détails. Par défaut, tous les détails sont renvoyés.
  • false - Renvoie une version tronquée des données d’alerte, qui exclut la description complète spécifique à la zone des détails de l’alerte (alertDetails).
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

SevereWeatherAlertsResult

La demande a réussi.

Other Status Codes

ErrorResponse

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-id pour 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 URL est 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
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.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’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.).

JsonFormat

Format souhaité de la réponse. Seul json format est pris en charge.

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.

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.

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.

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.

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.

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 identifie cette langue. Certains pays ou régions peuvent proposer à la fois leur langue maternelle et l’anglais.

alertDetailsLanguageCode

string

La langue de alertDetails, en tant que code ISO 639-1 Alpha-2 - par exemple, en-CA pour l’anglais canadien. Peut différer du texte demandé pour le reste de la réponse. Retourné seulement lorsque la demande demande tous les détails.

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

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 LatestStatusKeyword de la langue.

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 AlertArea .

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

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

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

ErrorDetail

Objet d’erreur.

JsonFormat

Format souhaité de la réponse. Seul json format est pris en charge.

Valeur Description
json

le format d’échange de données JavaScript Object Notation

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

LatestStatusKeyword

Le mot-clé statut en anglais (en-US) - l’une des valeurs définies par LatestStatusKeyword (New, Continue, Update, Correct, Extend, Upgrade, Cancel, , ou Expire). Toujours retourné en anglais, quelle que soit la langue demandée, ce qui le rend adapté à des vérifications de statut stables et indépendantes de la langue.

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 englishà .

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 à alertDetails, startTime, endTimeou class.

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

AlertArea[]

Les zones géographiques couvertes par l’alerte. Chacune AlertArea identifie une zone affectée par son nom, indique les heures de début et de fin de l’alerte pour cette zone, le statut d’alerte le plus récent, et (lorsque la demande demande tous les détails) le texte complet du détail de l’alerte. Une alerte peut couvrir une ou plusieurs zones – par exemple, une alerte de chaleur peut s’appliquer à plusieurs régions adjacentes sur le même avis.

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, NON-PRECIPITATION, PRECIPITATION, THUNDERSTORM, TROPICAL, ou FIRE. L’ensemble exact des valeurs dépend du fournisseur émettric.

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, US ou CA.

description

SevereWeatherAlertDescription

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 (localized) et en anglais (english).

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 à source. Adapté à une recherche stable et indépendante de la langue du fournisseur.

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 englishà .

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

SevereWeatherAlert[]

Les alertes météorologiques sévères actives à l’emplacement spécifié, classées par priority (priorité maximale en premier). Vide quand aucune alerte n’est activée.