Weather - Get Current Conditions

Service:: Maps

Version d’API:: 1.1

Permet d’obtenir les conditions météorologiques actuelles.
L’API Get Current Conditions est une requête HTTP GET qui renvoie des conditions météorologiques actuelles détaillées telles que les précipitations, la température et le vent pour un emplacement de coordonnées donné. En outre, il est possible de récupérer les observations des dernières 6 heures ou 24 heures pour un emplacement spécifique. Les informations de base renvoyées avec la réponse comprennent des détails tels que la date et l’heure de l’observation, une brève description des conditions météorologiques, l’icône météo, les indicateurs de précipitations et la température. Des détails supplémentaires tels que la température RealFeel™ et l’indice UV sont également renvoyés. Pour plus d’informations, voir Demander des données météorologiques en temps réel

GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}

Avec des paramètres facultatifs:

GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}&unit={unit}&details={details}&duration={duration}&language={language}

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 conditions actuelles. 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 de l’état actuel, qui comprend la date et l’heure d’observation, la phrase météorologique, le code de l’icône, l’indicateur de précipitations et la température.
duration	query		integer (int32)	Calendrier des conditions météorologiques retournées. Par défaut, les conditions météorologiques les plus récentes seront renvoyées. Valeur par défaut est 0. Les valeurs prises en charge sont les suivantes : `0` - Retour des conditions météorologiques les plus récentes. `6` - Retour aux conditions météorologiques des 6 dernières heures. `24` - Retour aux conditions météorologiques des dernières 24 heures.
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.
unit	query		WeatherDataUnit	Spécifie de renvoyer les données en unités métriques ou en unités impériales. La valeur par défaut est métrique.

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	CurrentConditionsResult	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 detailed current weather conditions for a given coordinate location

Exemple de requête

HTTP

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679

Exemple de réponse

Code d’état:: 200

{
  "results": [
    {
      "apparentTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 16.1
      },
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4359
      },
      "cloudCover": 95,
      "dateTime": "2019-11-14T15:08:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 9.2
      },
      "hasPrecipitation": false,
      "iconCode": 7,
      "isDayTime": true,
      "obstructionsToVisibility": "",
      "pastTwentyFourHourTemperatureDeparture": {
        "unit": "C",
        "unitType": 17,
        "value": 1.8
      },
      "phrase": "Cloudy",
      "precipitationSummary": {
        "past12Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past18Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past24Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past3Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past6Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past9Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "pastHour": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.5
        }
      },
      "pressure": {
        "unit": "mb",
        "unitType": 14,
        "value": 1014.9
      },
      "pressureTendency": {
        "code": "S",
        "localizedDescription": "Steady"
      },
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.6
      },
      "realFeelTemperatureShade": {
        "unit": "C",
        "unitType": 17,
        "value": 13.6
      },
      "relativeHumidity": 75,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.7
      },
      "temperatureSummary": {
        "past12Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 5.9
          }
        },
        "past24Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 5.9
          }
        },
        "past6Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 8.3
          }
        }
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 8
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 11.4
      },
      "wind": {
        "direction": {
          "degrees": 315,
          "localizedDescription": "NW"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 3.6
        }
      },
      "windChillTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.9
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 4.9
        }
      }
    }
  ]
}

Définitions

Nom	Description
CurrentConditions	Une seule observation météorologique pour l’emplacement spécifié, renvoyée par l’opération Get Current Conditions. Selon la `duration`demande , cette observation peut être la lecture la plus récente (la plus récente) ou l’une des observations horaires précédentes. Par défaut, un sous-ensemble simplifié est retourné : date et heure d’observation, phrase météo, code d’icône, indicateur de précipitations et température. Lorsque la demande demande tous les détails, chaque propriété est incluse, en ajoutant des mesures telles que le RealFeel, le point de rosée, le vent, la visibilité, la couverture nuageuse, la pression, ainsi que les résumés des précipitations et des températures des dernières heures.
CurrentConditionsResult	La réponse est renvoyée par l’opération Get Current Conditions (Obtenir les conditions de courant), contenant une ou plusieurs observations de conditions de courant pour un emplacement spécifié. Par défaut, une seule observation pour le temps présent est retournée ; lorsque le `duration` paramètre est fixé à 6 ou 24, la réponse inclut aussi une observation par heure passée sur cette fenêtre.
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.).
IconCode	Le code numérique des conditions météorologiques qui identifie quelle icône afficher. Chaque valeur de cette énumération correspond à une icône météo Azure Maps (comme Sunny, Cloudy ou Thunderstorms) et s’associe à une icône lisible `iconPhrase` par l’humain renvoyée à côté. Le même code peut apparaître dans les réponses courantes, horaires, quotidiennes, trimestrielles et minute par minute, permettant aux applications d’afficher un ensemble d’icônes cohérent sur tous les services météorologiques. Pour la liste complète des codes, les icônes auxquelles ils correspondent et des exemples d’images, voir Services météo dans Azure Maps.
JsonFormat	Format souhaité de la réponse. Seul `json` format est pris en charge.
PastHoursTemperature	Les températures de l’air les plus élevées et les plus basses observées lors d’une des fenêtres roulantes ( `TemperatureSummary` après 6, 12 ou 24 heures), en degrés Celsius (°C) ou Fahrenheit (°F) selon l’unité spécifiée dans la demande.
PrecipitationSummary	La précipitation liquide équivalente totale tombée au lieu d’observation sur les fenêtres roulantes se terminant au moment de l’observation. Chaque valeur couvre la fenêtre complète mesurée à partir de « maintenant » – par exemple, `past3Hours` c’est le total courant des trois dernières heures, pas seulement de la troisième heure – donc les fenêtres se chevauchent et les fenêtres plus longues incluent les précipitations rapportées pour les plus courtes. La neige et la glace contribuent à leur équivalent fondu (liquide). Indiqué en millimètres (mm) ou pouces (pouces) selon l’unité spécifiée dans la demande.
PressureTendency	La tendance récente de la pression atmosphérique – qu’elle augmente, baisse ou reste stable – est revenue à la fois sous forme de phrase localisée et de code d’une lettre. Utile pour anticiper les changements météorologiques à court terme ; la baisse de la pression signale souvent une détérioration météorologique, tandis que la hausse indique généralement une amélioration des conditions.
TemperatureSummary	Les températures de l’air les plus élevées et les plus basses observées à l’endroit sur des fenêtres roulantes se terminant au moment de l’observation. Chaque valeur couvre la fenêtre complète mesurée à partir du « maintenant » – par exemple, `past12Hours` rapporte le maximum et le bas sur les 12 heures les plus récentes, pas seulement la douzième heure – donc les fenêtres se chevauchent et les fenêtres plus longues incluent les températures rapportées pour les plus courtes. Indiqué en degrés Celsius (°C) ou Fahrenheit (°F) selon l’unité spécifiée dans la demande.
UnitType	Une valeur entière associée au type d’unité affichée. Par exemple, 17 pour Celsius, 18 pour Fahrenheit. Peut être utilisé pour la traduction unitaire. Pour plus d’informations, voir Services météorologiques en Azure Maps.
WeatherDataUnit	Précise s’il faut retourner les données en unités métriques ou impériales, avec métrique comme valeur par défaut. Par exemple: Métrique : millimètre (mm), mètre (m), kilomètre (km), Celsius (C) Impérial : pouce (pouce), pied (pied), mile (mi), Fahrenheit (F)
WeatherValue	Valeurs pour les indicateurs météorologiques tels que la température, le point de rosée et la vitesse du vent, présentées en unités métriques ou impériales, telles que spécifiées dans le paramètre unité URI. Pour plus d’informations, voir Types d’unités dans l’article Services météo dans Azure Maps.
WindDetails	Fournit la vitesse du vent prévue, mesurée en unités telles que les kilomètres par heure (km/h) ou les miles par heure (mph), selon l’unité spécifiée dans la demande. Indique également la direction du vent mesurée en degrés d’azimut, en commençant au nord véritable et se déplaçant dans le sens des aiguilles d’une montre. Le nord correspond à 0°, l’est à 90°, le sud à 180°, et l’ouest à 270°. Les valeurs possibles varient de 0° à 359°.
WindDirection	Fournit des détails sur la direction du vent, y compris la direction en degrés d’azimut et une abréviation localisée de la direction du vent.

CurrentConditions

Objet

Une seule observation météorologique pour l’emplacement spécifié, renvoyée par l’opération Get Current Conditions. Selon la durationdemande , cette observation peut être la lecture la plus récente (la plus récente) ou l’une des observations horaires précédentes. Par défaut, un sous-ensemble simplifié est retourné : date et heure d’observation, phrase météo, code d’icône, indicateur de précipitations et température. Lorsque la demande demande tous les détails, chaque propriété est incluse, en ajoutant des mesures telles que le RealFeel, le point de rosée, le vent, la visibilité, la couverture nuageuse, la pression, ainsi que les résumés des précipitations et des températures des dernières heures.

Nom	Type	Description
apparentTemperature	WeatherValue	La température apparente au moment de l’observation – la façon dont l’air est réellement perçu par les humains, en tenant compte de la température de l’air, de l’humidité relative et de la vitesse du vent. Mesuré en degrés Celsius (°C) ou Fahrenheit (°F), selon l’unité spécifiée dans la demande.
ceiling	WeatherValue	Le plafond nuageux au moment de l’observation – l’altitude au-dessus du sol de la couche nuageuse la plus basse – en pieds (ft) ou mètres (m) selon l’unité spécifiée dans la demande. Important pour l’aviation, car cela affecte la visibilité et les opérations en vol.
cloudCover	integer (int32)	Le pourcentage de ciel couvert de nuages au moment de l’observation va de 0 (dégagé) à 100 (couvert). Peut être NULL.
dateTime	string (date-time)	La date et l’heure de cette observation, au format RFC 3339 (yyyy-mm-ddThh :mm :ss-hh:mm). Par exemple, 2025-04-29T07:00:00-07:00.
dewPoint	WeatherValue	Le point de rosée au moment de l’observation – la température à laquelle l’air doit refroidir pour devenir saturé (100% humidité relative). Mesuré en degrés Celsius (°C) ou Fahrenheit (°F), selon l’unité spécifiée dans la demande. Un point de rosée plus élevé indique plus d’humidité dans l’air.
hasPrecipitation	boolean	`true` si des précipitations (pluie, neige, grésil ou grêle) se produisent au moment de l’observation ; sinon `false`.
iconCode	IconCode	Le code représentatif de l’icône météo pour cette observation, associé à la `phrase` propriété. La valeur numérique correspond à une icône météo Azure Maps – pour la liste complète, voir Services météo dans Azure Maps. Peut être NULL.
isDayTime	boolean	`true` si c’est de jour à l’endroit spécifié à l’heure d’observation ; `false` s’il est de nuit.
obstructionsToVisibility	string	Un code identifiant le facteur dominant réduisant la visibilité au moment de l’observation, tel que le brouillard, la fumée, la brume ou les précipitations. Utile pour des activités qui dépendent d’une visibilité nette, comme la conduite et l’aviation. Valeurs possibles : A = orage fort/grêle BD = poussière soufflée BN = sable soufflé BS = souffle de neige D = poussière F = brouillard GF = brouillard au sol HZ = brume I = glace IC = cristaux de glace SI = brouillard de glace IP = granulés de glace IPW = douche de granulés de glace K = fumée L = bruine R = pluie RS = pluie/neige RW = averse S = neige SG = granules de neige SP = boulettes de neige SW = averse de neige T = orage UP = précipitations indéfinies ZL = bruine verglaçante ZR = pluie verglaçante + = lourd - = lumière
pastTwentyFourHourTemperatureDeparture	WeatherValue	Le changement de température de l’air par rapport à il y a 24 heures, en degrés Celsius (°C) ou Fahrenheit (°F), selon l’unité spécifiée dans la demande. Les valeurs positives indiquent que l’air est plus chaud qu’hier à la même heure ; les valeurs négatives indiquent qu’il est plus frais.
phrase	string	Un terme descriptif court pour désigner les conditions météorologiques au moment de l’observation – par exemple, ensoleillé ou partiellement nuageux. Associé à `iconCode`, qui identifie l’icône météo correspondante. Pour plus d’informations, voir Services météorologiques en Azure Maps.
precipitationSummary	PrecipitationSummary	Un résumé des quantités de précipitations liquides équivalentes au site d’observation sur les fenêtres roulantes des dernières 1, 3, 6, 9, 12, 18 et 24 heures, en millimètres (mm) ou pouces (in) selon l’unité spécifiée dans la demande.
pressure	WeatherValue	La pression atmosphérique (air) au niveau du sol au moment de l’observation, en millibars (mb) ou pouces de mercure (inHg), selon l’unité spécifiée dans la demande.
pressureTendency	PressureTendency	La tendance récente de la pression atmosphérique - montante, baisse ou stable. Utile pour anticiper les changements météorologiques à court terme ; la baisse de la pression signale souvent une détérioration météorologique, tandis que la hausse indique généralement une amélioration des conditions.
realFeelTemperature	WeatherValue	La température RealFeel™ au moment de l’observation, en degrés Celsius (°C) ou Fahrenheit (°F), selon l’unité spécifiée dans la demande. Développé par AccuWeather, RealFeel combine la température de l’air avec l’humidité, le vent, la couverture nuageuse, l’intensité du soleil et d’autres facteurs pour indiquer la réelle sensation météorologique. Pour plus d’informations, consultez : Quelle est la température AccuWeather RealFeel ?
realFeelTemperatureShade	WeatherValue	La température RealFeel™ au moment de l’observation dans les zones ombragées, en degrés Celsius (°C) ou Fahrenheit (°F), selon l’unité spécifiée dans la demande. Comme `realFeelTemperature`, mais exclut l’effet de réchauffement de la lumière directe du soleil, donnant une meilleure idée de la sensation météo à l’ombre.
relativeHumidity	integer (int32)	L’humidité relative au moment de l’observation, exprimée en pourcentage de 0 à 100 de la quantité maximale de vapeur d’eau que l’air peut contenir à la même température.
temperature	WeatherValue	La température de l’air au moment de l’observation, en degrés Celsius (°C) ou Fahrenheit (°F), selon l’unité spécifiée dans la demande.
temperatureSummary	TemperatureSummary	Un résumé des températures atmosphériques les plus élevées et les plus basses observées à cet endroit sur les fenêtres roulantes des 6, 12 et 24 dernières heures, en degrés Celsius (°C) ou Fahrenheit (°F) selon l’unité spécifiée dans la demande.
uvIndex	integer (int32)	L’indice ultraviolet (UV) au moment de l’observation, indiquant le risque de dommages liés à une exposition non protégée au soleil. Les valeurs prises en charge sont les suivantes : 0-2 : Faible danger des rayons UV du soleil pour la personne moyenne. 3-5 : Risque modéré de dommages liés à une exposition solaire non protégée. 6-7 : Risque élevé de dommages dus à une exposition non protégée au soleil. 8-10 : Risque très élevé de dommages dus à une exposition non protégée au soleil. 11+ : Risque extrême de dommages dus à une exposition non protégée au soleil.
uvIndexPhrase	string	Une étiquette descriptive courte pour `uvIndex` – par exemple, Faible, Modéré, Élevé, Très Élevé ou Extrême.
visibility	WeatherValue	La visibilité horizontale au moment de l’observation – la distance à laquelle un objet ou une lumière peut être clairement discernée – en kilomètres (km) ou miles (mi) selon l’unité spécifiée dans la demande.
wetBulbTemperature	WeatherValue	La température de l’ampoule humide au moment de l’observation – la température que l’air atteindrait s’il était refroidi jusqu’à la saturation (100% humidité relative) en évaporant de l’eau à pression constante. Mesuré en degrés Celsius (°C) ou Fahrenheit (°F), selon l’unité spécifiée dans la demande. Utile pour évaluer la contrainte thermique et le refroidissement par évaporation.
wind	WindDetails	La vitesse et la direction du vent au moment de l’observation. La vitesse est en kilomètres par heure (km/h) ou en miles par heure (mph) selon l’unité spécifiée dans la demande ; la direction est en degrés d’azimut, mesurée dans le sens horaire à partir du Nord vrai (0° = N, 90° = E, 180° = S, 270° = W).
windChillTemperature	WeatherValue	La température du refroidissement éolien au moment de l’observation - la température que l’air ressent sur la peau exposée due à l’effet combiné du vent et de la basse température. Généralement plus bas que la température réelle de l’air. Mesuré en degrés Celsius (°C) ou Fahrenheit (°F), selon l’unité spécifiée dans la demande.
windGust	WindDetails	La vitesse et la direction maximales de rafale de vent court au moment de l’observation, en utilisant les mêmes unités et la même convention d’azimut que `wind`. Les rafales de vent sont de brèves pics de vitesse qui peuvent affecter des activités telles que l’aviation, la voile, le cerf-volant et d’autres événements en plein air.

CurrentConditionsResult

Objet

La réponse est renvoyée par l’opération Get Current Conditions (Obtenir les conditions de courant), contenant une ou plusieurs observations de conditions de courant pour un emplacement spécifié. Par défaut, une seule observation pour le temps présent est retournée ; lorsque le duration paramètre est fixé à 6 ou 24, la réponse inclut aussi une observation par heure passée sur cette fenêtre.

Nom	Type	Description
results	CurrentConditions[]	Les observations des conditions actuelles, dans l’ordre chronologique avec la plus récente en premier. Par défaut, une seule entrée - la dernière observation est retourné ; la réponse peut également contenir une entrée par heure sur une fenêtre roulante récente (généralement les 6 ou 24 dernières heures), selon la demande.

Nom

Type

Description

results

CurrentConditions[]

Les observations des conditions actuelles, dans l’ordre chronologique avec la plus récente en premier. Par défaut, une seule entrée - la dernière observation

est retourné ; la réponse peut également contenir une entrée par heure sur une fenêtre roulante récente (généralement les 6 ou 24 dernières heures), selon la demande.

ErrorAdditionalInfo

Objet

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

Objet

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

Objet

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.

IconCode

Énumération

Le code numérique des conditions météorologiques qui identifie quelle icône afficher. Chaque valeur de cette énumération correspond à une icône météo Azure Maps (comme Sunny, Cloudy ou Thunderstorms) et s’associe à une icône lisible iconPhrase par l’humain renvoyée à côté. Le même code peut apparaître dans les réponses courantes, horaires, quotidiennes, trimestrielles et minute par minute, permettant aux applications d’afficher un ensemble d’icônes cohérent sur tous les services météorologiques.

Pour la liste complète des codes, les icônes auxquelles ils correspondent et des exemples d’images, voir Services météo dans Azure Maps.

Valeur	Description
1	Sunny
2	Ensoleillé
3	Partiellement ensoleillé
4	Nuages intermittents
5	Soleil brumeux
6	Nuageux
7	Cloudy
8	Morne (Couvert)
11	Brouillard
12	Showers
13	Principalement nuageux avec des averses
14	Partiellement ensoleillé avec des averses
15	Thunderstorms
16	Principalement nuageux avec des orages
17	Partiellement ensoleillé avec des orages
18	Pluie
19	Flurries
20	Principalement nuageux avec des averses de neige
21	Partiellement ensoleillé avec des averses de neige
22	Snow
23	Principalement nuageux avec de la neige
24	Glace
25	Neige fondue
26	Pluie verglaçante
29	Pluie et neige
30	Hot
31	Froid
32	Windy
33	Effacer
34	Principalement clair
35	Nuageux
36	Nuages intermittents
37	Clair de lune brumeux
38	Nuageux
39	Partiellement nuageux avec des averses
40	Principalement nuageux avec des averses
41	Partiellement nuageux avec des orages
42	Principalement nuageux avec des orages
43	Principalement nuageux avec des averses de neige
44	Principalement nuageux avec de la neige

JsonFormat

Énumération

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

PastHoursTemperature

Objet

Les températures de l’air les plus élevées et les plus basses observées lors d’une des fenêtres roulantes ( TemperatureSummary après 6, 12 ou 24 heures), en degrés Celsius (°C) ou Fahrenheit (°F) selon l’unité spécifiée dans la demande.

Nom	Type	Description
maximum	WeatherValue	La température la plus élevée observée pendant la fenêtre.
minimum	WeatherValue	La température la plus basse observée pendant la fenêtre.

PrecipitationSummary

Objet

La précipitation liquide équivalente totale tombée au lieu d’observation sur les fenêtres roulantes se terminant au moment de l’observation. Chaque valeur couvre la fenêtre complète mesurée à partir de « maintenant » – par exemple, past3Hours c’est le total courant des trois dernières heures, pas seulement de la troisième heure – donc les fenêtres se chevauchent et les fenêtres plus longues incluent les précipitations rapportées pour les plus courtes. La neige et la glace contribuent à leur équivalent fondu (liquide). Indiqué en millimètres (mm) ou pouces (pouces) selon l’unité spécifiée dans la demande.

Nom	Type	Description
past12Hours	WeatherValue	Précipitations liquides équivalentes tombées au cours des 12 dernières heures.
past18Hours	WeatherValue	Précipitations équivalentes liquides tombées au cours des 18 dernières heures.
past24Hours	WeatherValue	Précipitations liquides équivalentes qui sont tombées au cours des dernières 24 heures.
past3Hours	WeatherValue	Précipitations liquides équivalentes tombées au cours des 3 dernières heures.
past6Hours	WeatherValue	Précipitations liquides équivalentes tombées au cours des 6 dernières heures.
past9Hours	WeatherValue	Précipitations liquides équivalentes tombées au cours des 9 dernières heures.
pastHour	WeatherValue	Précipitations liquides équivalentes tombées dans la dernière heure.

PressureTendency

Objet

La tendance récente de la pression atmosphérique – qu’elle augmente, baisse ou reste stable – est revenue à la fois sous forme de phrase localisée et de code d’une lettre. Utile pour anticiper les changements météorologiques à court terme ; la baisse de la pression signale souvent une détérioration météorologique, tandis que la hausse indique généralement une amélioration des conditions.

Nom	Type	Description
code	string	Un code indépendant de la langue d’une lettre pour la tendance à la pression : F = Baisse, S = Stable, R = Ascendante.
localizedDescription	string	Une courte phrase décrivant la tendance à la pression – par exemple, Chute, Stable ou Montant – était renvoyée dans le langage spécifié dans la demande.

TemperatureSummary

Objet

Les températures de l’air les plus élevées et les plus basses observées à l’endroit sur des fenêtres roulantes se terminant au moment de l’observation. Chaque valeur couvre la fenêtre complète mesurée à partir du « maintenant » – par exemple, past12Hours rapporte le maximum et le bas sur les 12 heures les plus récentes, pas seulement la douzième heure – donc les fenêtres se chevauchent et les fenêtres plus longues incluent les températures rapportées pour les plus courtes. Indiqué en degrés Celsius (°C) ou Fahrenheit (°F) selon l’unité spécifiée dans la demande.

Nom	Type	Description
past12Hours	PastHoursTemperature	Les températures les plus élevées et les plus basses observées au cours des 12 dernières heures.
past24Hours	PastHoursTemperature	Les températures les plus élevées et les plus basses observées au cours des dernières 24 heures.
past6Hours	PastHoursTemperature	Les températures les plus élevées et les plus basses ont été observées au cours des 6 dernières heures.

UnitType

Énumération

Une valeur entière associée au type d’unité affichée. Par exemple, 17 pour Celsius, 18 pour Fahrenheit. Peut être utilisé pour la traduction unitaire. Pour plus d’informations, voir Services météorologiques en Azure Maps.

Valeur	Description
0	feet
1	inches
2	miles
3	millimeter
4	centimeter
5	meter
6	kilometer
7	kilometersPerHour
8	knots
9	milesPerHour
10	metersPerSecond
11	hectoPascals
12	inchesOfMercury
13	kiloPascals
14	millibars
15	millimetersOfMercury
16	poundsPerSquareInch
17	Celsius
18	Fahrenheit
19	kelvin
20	percent
21	flotter
22	entier
31	MicrogramsPerCubicMeterOfAir

WeatherDataUnit

Énumération

Précise s’il faut retourner les données en unités métriques ou impériales, avec métrique comme valeur par défaut. Par exemple:

Métrique : millimètre (mm), mètre (m), kilomètre (km), Celsius (C)
Impérial : pouce (pouce), pied (pied), mile (mi), Fahrenheit (F)

Valeur	Description
imperial	Retourner les données en utilisant des unités impériales telles que Fahrenheit (F) pour la température et les miles (mi) pour la distance.
metric	Renvoie les données à l’aide d’unités métriques telles que Celsius (C) pour la température et kilomètre (km) pour la distance.

WeatherValue

Objet

Valeurs pour les indicateurs météorologiques tels que la température, le point de rosée et la vitesse du vent, présentées en unités métriques ou impériales, telles que spécifiées dans le paramètre unité URI. Pour plus d’informations, voir Types d’unités dans l’article Services météo dans Azure Maps.

Nom	Type	Description
unit	string	L’unité de mesure utilisée dans la valeur de retour, comme « C » pour Celsius, « F » pour Fahrenheit.
unitType	UnitType	Un entier représentant le type d’unité. Par exemple, 0 pour les pieds, 1 pour les pouces, 2 pour les miles. Pour une liste complète, voir Types d’unités dans l’article Services météo dans Azure Maps.
value	number (float)	La valeur mesurée exprimée dans l’unité spécifiée.

WindDetails

Objet

Fournit la vitesse du vent prévue, mesurée en unités telles que les kilomètres par heure (km/h) ou les miles par heure (mph), selon l’unité spécifiée dans la demande. Indique également la direction du vent mesurée en degrés d’azimut, en commençant au nord véritable et se déplaçant dans le sens des aiguilles d’une montre. Le nord correspond à 0°, l’est à 90°, le sud à 180°, et l’ouest à 270°. Les valeurs possibles varient de 0° à 359°.

Nom	Type	Description
direction	WindDirection	La direction du vent est mesurée en degrés d’azimut, partant du Nord vrai (0°) et se déplaçant dans le sens des aiguilles d’une montre. L’est correspond à 90°, le sud à 180°, et l’ouest à 270°. Les valeurs possibles varient de 0° à 359°. Cette propriété renvoie un entier représentant la direction du vent.
speed	WeatherValue	La vitesse du vent attendue, mesurée en kilomètres par heure (km/h) ou en miles par heure (mph), selon l’unité spécifiée dans la demande.

WindDirection

Objet

Fournit des détails sur la direction du vent, y compris la direction en degrés d’azimut et une abréviation localisée de la direction du vent.

Nom	Type	Description
degrees	integer (int32)	La direction du vent est mesurée en degrés d’azimut, partant du nord véritable et se déplaçant dans le sens des aiguilles d’une montre. Le nord correspond à 0 degré, l’est à 90 degrés, le sud à 180 degrés, et l’ouest à 270 degrés. Les valeurs possibles varient de 0 à 359 degrés.
localizedDescription	string	Une abréviation localisée de la direction du vent, renvoyée dans la langue spécifiée dans la demande. Par exemple, `N` pour le Nord, `E` pour l’Est, `S` pour le Sud et `W` pour l’Ouest.