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
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 se voir accorder un accès via un rôle intégré ou un rôle personnalisé composé d’une ou plusieurs permissions pour Azure Maps les API REST.\n\nPour implémenter des scénarios, nous recommandons de consulter les concepts d’authentification . En résumé, cette définition de sécurité offre une solution pour modéliser l’application via des objets capables de contrôler l’accès sur des API et des périmètres spécifiques.\n\n#### Notes\n* Cette définition de sécurité exige l’utilisation de l’en-tête x-ms-client-id pour indiquer à quelle ressource Azure Maps l’application demande l’accédre. Cela peut être acquis via l’API de gestion Maps.\n* \nLe Authorization URL est spécifique à l’instance Azure cloud public. Les clouds souverains disposent d’URL d’autorisation uniques et de configurations d’identifiants Microsoft Entra ID. \n* \nLe contrôle d’accès basé sur les rôles Azure est configuré depuis le plan de gestion Azure via Azure portail, PowerShell, CLI, SDK Azure ou API REST.\n* \nUtilisation du Azure Maps Web SDK permet une configuration basée sur la configuration d’une application pour plusieurs cas d’usage.\n* Pour plus d’informations sur Plateforme d'identités Microsoft, voir Plateforme d'identités Microsoft aperçu .

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 qui est provisionnée lorsque vous Créez un compte Azure Maps dans le portail Azure ou en utilisant PowerShell, CLI, SDK Azure ou API REST.\n\n Avec cette clé, toute application peut accéder à toutes les API REST. En d’autres termes, cette clé peut être utilisée comme une clé maîtresse dans le compte où elle est émise.\n\n Pour les applications exposées publiquement, notre recommandation est d’utiliser l’approche applications clientes confidentielles pour accéder Azure Maps API REST 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 Azure portail, PowerShell, CLI, SDK Azure ou API REST.\n\n Avec ce jeton, toute application est autorisée à y accéder avec Azure contrôles d’accès basés sur les rôles et un contrôle précis de l’expiration, du taux et des régions d’utilisation pour le jeton particulier. En d’autres termes, le jeton SAS 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.\n\n Pour les applications publiquement exposées, notre recommandation est de configurer une liste spécifique des origines autorisées sur la ressource du compte Map afin de limiter les abus de rendu et de renouveler régulièrement le jeton SAS.

Type: apiKey
Dans: header

Exemples

Successfully retrieve detailed current weather conditions for a given coordinate location

Exemple de requête

HTTP

GET {endpoint}/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	Données météorologiques actuelles.
CurrentConditionsResult	Les conditions météorologiques actuelles en résultent.
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	Valeur numérique représentant une image qui correspond aux conditions météorologiques actuelles décrites par la `Phrase` propriété. Pour plus d’informations, voir Services météorologiques en Azure Maps. Peut être NULL.
JsonFormat	Format souhaité de la réponse. Seul `json` format est pris en charge.
PastHoursTemperature	Résumé des fluctuations de température au cours des dernières heures.
PrecipitationSummary	Résumé des quantités de précipitations.
PressureTendency	Tendance à la pression atmosphérique.
TemperatureSummary	Résumé des fluctuations de température.
UnitType	Entier représentant le type d’unité. Par exemple, 17 pour Celsius, 18 pour Fahrenheit. Peut être utilisé pour la traduction unitaire. Pour une liste complète, voir Services météorologiques en Azure Maps.
WeatherDataUnit	Unité de mesure pour les données météorologiques.
WeatherValue	Valeur spécifique d’une unité donnée liée aux conditions météorologiques.
WindDetails	Les détails du vent sont renvoyés, y compris la vitesse et la direction.
WindDirection	Direction du vent

CurrentConditions

Objet

Données météorologiques actuelles.

Nom	Type	Description
apparentTemperature	WeatherValue	Température extérieure perçue causée par la combinaison de la température de l’air, de l’humidité relative et de la vitesse du vent dans l’unité spécifiée.
ceiling	WeatherValue	Plafond nuageux dans l’unité spécifiée. Le plafond est une mesure de la hauteur de la base des nuages les plus bas.
cloudCover	integer (int32)	Pourcentage représentant la couverture nuageuse.
dateTime	string (date-time)	Date et heure de l’observation actuelle affichées au format ISO 8601 , par exemple, 2019-10-27T19:39:57-08:00.
dewPoint	WeatherValue	Température du point de rosée dans l’unité spécifiée. La température du point de rosée est la température à laquelle l’air doit être refroidi pour atteindre la saturation.
hasPrecipitation	boolean	Une valeur booléenne indiquant si des précipitations (pluie, neige, grésil ou grêle) sont attendues pendant la période spécifiée. Retour vrai si des précipitations sont attendues, sinon faux.
iconCode	IconCode	Valeur numérique représentant une image qui correspond aux conditions météorologiques actuelles décrites par la `Phrase` propriété. Pour plus d’informations, voir Services météorologiques en Azure Maps. Peut être NULL.
isDayTime	boolean	Indique l’heure de la journée. True indique 'jour', false indique 'nuit.
obstructionsToVisibility	string	Cause de la visibilité limitée. Valeurs possibles : A = orage violent/grêle BD = souffler de la poussière BN = souffler du sable BS = poudrerie D = poussière F = brouillard GF = brouillard au sol HZ = brume I = glace IC = cristaux de glace IF = brouillard givrant IP = granules de glace IPW = douche aux granulés de glace K = fumée L = bruine R = pluie RS = pluie/neige RW = douche à effet pluie S = neige SG = granulés de neige SP = granules 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	Écart par rapport à la température observée il y a 24 heures dans l’unité spécifiée.
phrase	string	Formulation de la description de la condition météorologique actuelle. Affiché dans la langue spécifiée.
precipitationSummary	PrecipitationSummary	Résumé des quantités de précipitations au cours des dernières 24 heures.
pressure	WeatherValue	Pression atmosphérique dans l’unité spécifiée.
pressureTendency	PressureTendency	Changement de pression atmosphérique.
realFeelTemperature	WeatherValue	RealFeel™ Temperature en cours de retour.
realFeelTemperatureShade	WeatherValue	RealFeel™ Temperature en cours de retour. Décrit la sensation réelle de la température à l'ombre.
relativeHumidity	integer (int32)	L’humidité relative est la quantité de vapeur d’eau présente dans l’air, exprimée en pourcentage de la quantité nécessaire à la saturation à la même température.
temperature	WeatherValue	Température en cours de retour.
temperatureSummary	TemperatureSummary	Résumé des fluctuations de température au cours des 6, 12 et 24 dernières heures.
uvIndex	integer (int32)	Mesure de l’intensité du rayonnement ultraviolet du soleil. Les valeurs prises en charge sont les suivantes : `0-2` - Faible danger des rayons UV du soleil ou de la personne moyenne. `3-5` - Risque modéré de dommages causés par une exposition au soleil non protégée. `6-7` - Risque élevé de dommages causés par une exposition au soleil non protégée. `8-10` - Risque très élevé de dommages dus à une exposition au soleil non protégée. `11+` - Risque extrême de dommages causés par une exposition au soleil non protégée.
uvIndexPhrase	string	Phrase associée au `uvIndex`.
visibility	WeatherValue	Visibilité dans l’unité spécifiée. Mesure de la distance à laquelle un objet ou une lumière peut être clairement discerné.
wetBulbTemperature	WeatherValue	Température à laquelle l’air peut être refroidi en y évaporant de l’eau à pression constante jusqu’à ce qu’il atteigne la saturation.
wind	WindDetails	Les détails du vent sont renvoyés, y compris la vitesse et la direction.
windChillTemperature	WeatherValue	Température de l’air perçue sur la peau exposée en raison du vent.
windGust	WindDetails	Rafale de vent. Une rafale de vent est une augmentation soudaine et brève de la vitesse du vent.

CurrentConditionsResult

Objet

Les conditions météorologiques actuelles en résultent.

Nom	Type	Description
results	CurrentConditions[]	Conditions météorologiques actuelles détaillées.

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

Valeur numérique représentant une image qui correspond aux conditions météorologiques actuelles décrites par la Phrase propriété. Pour plus d’informations, voir Services météorologiques en Azure Maps. Peut être NULL.

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 (nuit)
37	Clair de lune brumeux
38	Nuageux dans l’ensemble (nuit)
39	Partiellement nuageux avec des averses
40	Généralement nuageux avec averses (nuit)
41	Partiellement nuageux avec des orages
42	Généralement nuageux avec orages (nuit)
43	Généralement nuageux avec averses (nuit)
44	Nuageux dans l’ensemble avec neige (nuit)

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

Résumé des fluctuations de température au cours des dernières heures.

Nom	Type	Description
maximum	WeatherValue	maximum
minimum	WeatherValue	minimum

PrecipitationSummary

Objet

Résumé des quantités de précipitations.

Nom	Type	Description
past12Hours	WeatherValue	La quantité de précipitations (équivalent liquide) qui est tombée au cours des 12 dernières heures.
past18Hours	WeatherValue	La quantité de précipitations (équivalent liquide) qui a chuté au cours des 18 dernières heures.
past24Hours	WeatherValue	La quantité de précipitations (équivalent liquide) qui a chuté au cours des dernières 24 heures.
past3Hours	WeatherValue	La quantité de précipitations (équivalent liquide) qui a chuté au cours des trois dernières heures.
past6Hours	WeatherValue	La quantité de précipitations (équivalent liquide) qui a chuté au cours des six dernières heures. Contient les valeurs métriques et impériales.
past9Hours	WeatherValue	La quantité de précipitations (équivalent liquide) qui a chuté au cours des neuf dernières heures.
pastHour	WeatherValue	La quantité de précipitations (équivalent liquide) qui sont tombées au cours de la dernière heure.

PressureTendency

Objet

Tendance à la pression atmosphérique.

Nom	Type	Description
code	string	Code de tendance de la pression quelle que soit la langue. L’un des suivants : F = Chute, S = Stable, R = Montant.
localizedDescription	string	Description de la tendance de la pression dans la langue spécifiée

TemperatureSummary

Objet

Résumé des fluctuations de température.

Nom	Type	Description
past12Hours	PastHoursTemperature	Résumé des fluctuations de température au cours des 12 dernières heures.
past24Hours	PastHoursTemperature	Résumé des fluctuations de température au cours des dernières 24 heures.
past6Hours	PastHoursTemperature	Résumé des fluctuations de température au cours des 6 dernières heures.

UnitType

Énumération

Entier représentant le type d’unité. Par exemple, 17 pour Celsius, 18 pour Fahrenheit. Peut être utilisé pour la traduction unitaire. Pour une liste complète, 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

Unité de mesure pour les données météorologiques.

Valeur	Description
imperial	Retournez les données à l’aide d’unités impériales telles que Fahrenheit (F) pour la température et mile (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

Valeur spécifique d’une unité donnée liée aux conditions météorologiques.

Nom	Type	Description
unit	string	Type d’unité pour la valeur renvoyée.
unitType	UnitType	Entier représentant le type d’unité. Par exemple, 17 pour Celsius, 18 pour Fahrenheit. Peut être utilisé pour la traduction unitaire. Pour une liste complète, voir Services météorologiques en Azure Maps.
value	number (float)	Valeur arrondie.

WindDetails

Objet

Les détails du vent sont renvoyés, y compris la vitesse et la direction.

Nom	Type	Description
direction	WindDirection	Direction du vent
speed	WeatherValue	Vitesse du vent dans l’unité spécifiée.

WindDirection

Objet

Direction du vent

Nom	Type	Description
degrees	integer (int32)	Direction du vent en degrés azimutaux, en commençant par le nord vrai et en continuant dans le sens des aiguilles d’une montre. Le nord est de 0 degrés, est de 90 degrés, le sud est de 180 degrés, l’ouest est de 270 degrés. Valeurs possibles 0-359.
localizedDescription	string	Abréviation de la direction dans la langue spécifiée.