Weather - Get Current Conditions

Référence

Service:: Maps

Version d'API:: 1.1

Utilisez pour obtenir les conditions météorologiques actuelles.

L’API Get Current Conditions est une requête HTTP GET qui retourne 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 retournées avec La réponse incluent des détails tels que la date et l’heure d’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 retournés. Pour plus d’informations, consultez Demander des données météorologiques en temps réel.

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query={query}

Avec des paramètres facultatifs:

GET https://atlas.microsoft.com/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
format	path	True	JsonFormat	Format souhaité de la réponse. Seul le format `json` est pris en charge.
api-version	query	True	string	Numéro de version de l’API Azure Maps.
query	query	True	number[]	Requête applicable spécifiée sous la forme d’une chaîne séparée par des virgules composée par latitude suivie de longitude, par exemple « 47.641268,-122.125679 ».
details	query		string	Retournez tous les détails des conditions actuelles. Les valeurs disponibles sont `true` - Retourne tous les détails. Par défaut, tous les détails sont retournés. `false` - Retourne une version tronquée des données d’état actuelles, qui comprend l’heure de date d’observation, l’expression météo, le code d’icône, l’indicateur de précipitations et la température.
duration	query		integer	Période des conditions météorologiques retournées. Par défaut, les conditions météorologiques les plus actuelles seront retournées. La valeur par défaut est 0. Les valeurs prises en charge sont les suivantes : `0` - Retourner les conditions météorologiques les plus actuelles. `6` - Retour des conditions météorologiques des 6 dernières heures. `24` - Retour des conditions météorologiques des dernières 24 heures.
language	query		string	Langue dans laquelle les résultats de la recherche doivent être retournés. Doit être l’une des balises de langue 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	Spécifie quel compte est destiné à être utilisé conjointement avec le modèle de sécurité de l’ID Microsoft Entra. Il représente un ID unique pour le compte Azure Maps et peut être récupéré à partir de l’API Compte du plan de gestion Azure Maps. Pour utiliser la sécurité des ID Microsoft Entra dans Azure Maps, consultez les articles suivants pour obtenir des conseils.

Réponses

Nom	Type	Description
200 OK	CurrentConditionsResult	Ok
Other Status Codes	ErrorResponse	Une erreur inattendue s’est produite.

Sécurité

AADToken

Il s’agit des flux OAuth Microsoft Entra 2.0 . Lorsqu’il est associé au contrôle d’accès en fonction du rôle Azure , il peut être utilisé pour contrôler l’accès aux API REST Azure Maps. Les contrôles d’accès en fonction du rôle Azure sont utilisés pour désigner l’accès à un ou plusieurs comptes de ressources Ou sous-ressources Azure Maps. Tout utilisateur, groupe ou principal de service peut se voir accorder l’accès via un rôle intégré ou un rôle personnalisé composé d’une ou plusieurs autorisations aux API REST Azure Maps.

Pour implémenter des scénarios, nous vous recommandons d’afficher les concepts d’authentification. En résumé, cette définition de sécurité fournit une solution pour modéliser des applications via des objets capables de contrôler l’accès sur des API et des étendues spécifiques.

Notes

Cette définition de sécurité nécessite l’utilisation de l’en-tête x-ms-client-id pour indiquer à quelle ressource Azure Maps l’application demande l’accès. Vous pouvez l’acquérir à partir de l’API de gestion Maps .

Authorization URL est spécifique à l’instance de cloud public Azure. Les clouds souverains ont des URL d’autorisation uniques et des configurations d’ID Microsoft Entra. * Le contrôle d’accès en fonction du rôle Azure est configuré à partir du 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 une 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	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 à l’aide de PowerShell, de l’interface CLI, des SDK Azure ou de l’API REST.

Avec cette clé, n’importe quelle 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 elle est émise.

Pour les applications exposées publiquement, nous vous recommandons d’utiliser l’approche des applications clientes confidentielles pour accéder aux API REST Azure Maps afin que votre clé puisse être stockée en toute sécurité.

Type: apiKey
Dans: query

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, l’interface CLI, les SDK Azure 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 de grain 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, notre recommandation est de configurer une liste spécifique d’origines autorisées sur la ressource de compte Map afin de limiter les abus de rendu et de 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": [
    {
      "dateTime": "2019-11-14T15:08:00-08:00",
      "phrase": "Cloudy",
      "iconCode": 7,
      "hasPrecipitation": false,
      "isDayTime": true,
      "temperature": {
        "value": 13.7,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 13.6,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperatureShade": {
        "value": 13.6,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 75,
      "dewPoint": {
        "value": 9.2,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 315,
          "localizedDescription": "NW"
        },
        "speed": {
          "value": 3.6,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 4.9,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "value": 8,
        "unit": "km",
        "unitType": 6
      },
      "obstructionsToVisibility": "",
      "cloudCover": 95,
      "ceiling": {
        "value": 4359,
        "unit": "m",
        "unitType": 5
      },
      "pressure": {
        "value": 1014.9,
        "unit": "mb",
        "unitType": 14
      },
      "pressureTendency": {
        "localizedDescription": "Steady",
        "code": "S"
      },
      "pastTwentyFourHourTemperatureDeparture": {
        "value": 1.8,
        "unit": "C",
        "unitType": 17
      },
      "apparentTemperature": {
        "value": 16.1,
        "unit": "C",
        "unitType": 17
      },
      "windChillTemperature": {
        "value": 13.9,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 11.4,
        "unit": "C",
        "unitType": 17
      },
      "precipitationSummary": {
        "pastHour": {
          "value": 0.5,
          "unit": "mm",
          "unitType": 3
        },
        "pastThreeHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastSixHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastNineHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastTwelveHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastEighteenHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastTwentyFourHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        }
      },
      "temperatureSummary": {
        "pastSixHours": {
          "minimum": {
            "value": 8.3,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "pastTwelveHours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "pastTwentyFourHours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        }
      }
    }
  ]
}

Définitions

Nom	Description
CurrentConditions
CurrentConditionsResult
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
IconCode	Valeur numérique représentant une image qui affiche le `iconPhrase`. Pour plus d’informations, consultez Services météorologiques dans Azure Maps .
JsonFormat	Format souhaité de la réponse. Seul le format `json` est pris en charge.
PastHoursTemperature	Résumé des fluctuations de température sur le nombre d’heures passées.
PrecipitationSummary
PressureTendency
TemperatureSummary
UnitType	Valeur d’ID numérique associée au type d’unité affiché. Peut être utilisé pour la traduction d’unités. Pour plus d’informations, consultez Services météorologiques dans Azure Maps .
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.
WeatherUnit	Valeur spécifique d’une unité donnée liée à la météo.
WindDetails	Détails du vent retournés, y compris la vitesse et la direction.
WindDirection	Sens du vent

CurrentConditions

Nom	Type	Description
apparentTemperature	WeatherUnit	Température extérieure perçue 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	WeatherUnit	Plafond cloud dans l’unité spécifiée. Le plafond est une mesure de la hauteur de la base des nuages les plus bas.
cloudCover	integer	Pourcentage représentant la couverture cloud.
dateTime	string	Date et heure de l’observation actuelle affichée au format ISO 8601, par exemple, 2019-10-27T19:39:57-08:00.
dewPoint	WeatherUnit	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	Indique la présence ou l’absence de précipitations. True indique la présence de précipitations, false indique l’absence de précipitations.
iconCode	IconCode	Valeur numérique représentant une image qui affiche le `iconPhrase`. Pour plus d’informations, consultez Services météorologiques dans Azure Maps .
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 = poussière soufflante BN = soufflage du sable BS = soufflage de la neige D = poussière F = brouillard GF = brouillard au sol HZ = brume I = glace IC = cristaux de glace IF = brouillard de glace IP = boulettes de glace IPW = douche de boulettes de glace K = fumée L = bruine R = pluie RS = pluie/neige RW = averse de pluie S = neige SG = granules de neige SP = boulettes de neige SW = averse de neige T = orage UP = précipitations non définies ZL = bruine verglaçante ZR = pluie verglaçante + = lourd - = lumière
pastTwentyFourHourTemperatureDeparture	WeatherUnit	Départ de la température observée il y a 24 heures dans l’unité spécifiée.
phrase	string	Description de la phrase de l’état météorologique actuel. Affiché dans la langue spécifiée.
precipitationSummary	PrecipitationSummary	Résumé des précipitations au cours des dernières 24 heures.
pressure	WeatherUnit	Pression atmosphérique dans l’unité spécifiée.
pressureTendency	PressureTendency	Changement de pression atmosphérique.
realFeelTemperature	WeatherUnit	RealFeel™ Temperature étant retourné.
realFeelTemperatureShade	WeatherUnit	RealFeel™ Temperature étant retourné. Décrit à quoi ressemble vraiment la température à l’ombre.
relativeHumidity	integer	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	WeatherUnit	Température retournée.
temperatureSummary	TemperatureSummary	Résumé des fluctuations de température au cours des dernières 6, 12 et 24 heures.
uvIndex	integer	Mesure de la force 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 liés à l’exposition au soleil non protégée. `6-7` - Risque élevé de dommages dus à 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 liés à l’exposition au soleil non protégée.
uvIndexPhrase	string	Expression associée à .`uvIndex`
visibility	WeatherUnit	Visibilité dans l’unité spécifiée. Mesure de la distance à laquelle un objet ou une lumière peut être clairement discerné.
wetBulbTemperature	WeatherUnit	Température à laquelle l’air peut être refroidi en évaporant l’eau à pression constante jusqu’à ce qu’il atteigne la saturation.
wind	WindDetails	Détails du vent retournés, y compris la vitesse et la direction.
windChillTemperature	WeatherUnit	Température de l’air perçue sur la peau exposée en raison du vent.
windGust	WindDetails	Rafale de vent. La rafale de vent est une augmentation soudaine et brève de la vitesse du vent.

CurrentConditionsResult

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

ErrorAdditionalInfo

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

Nom	Type	Description
info	object	Informations supplémentaires
type	string	Type d’informations supplémentaires.

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 d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

IconCode

Valeur numérique représentant une image qui affiche le iconPhrase. Pour plus d’informations, consultez Services météorologiques dans Azure Maps .

Nom	Type	Description
1	Integer
10	Integer
11	Integer
12	Integer
13	Integer
14	Integer
15	Integer
16	Integer
17	Integer
18	Integer
19	Integer
2	Integer
20	Integer
21	Integer
22	Integer
23	Integer
24	Integer
25	Integer
26	Integer
27	Integer
28	Integer
29	Integer
3	Integer
30	Integer
31	Integer
32	Integer
33	Integer
34	Integer
35	Integer
36	Integer
37	Integer
38	Integer
39	Integer
4	Integer
40	Integer
41	Integer
42	Integer
43	Integer
44	Integer
5	Integer
6	Integer
7	Integer
8	Integer
9	Integer

JsonFormat

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

Nom	Type	Description
json	string	Format d’échange de données de notation d’objet JavaScript

PastHoursTemperature

Résumé des fluctuations de température sur le nombre d’heures passées.

Nom	Type	Description
maximum	WeatherUnit	maximum
minimum	WeatherUnit	minimum

PrecipitationSummary

Nom	Type	Description
pastEighteenHours	WeatherUnit	Quantité de précipitations (équivalent liquide) qui a diminué au cours des 18 dernières heures.
pastHour	WeatherUnit	Quantité de précipitations (équivalent liquide) qui a chuté au cours de la dernière heure.
pastNineHours	WeatherUnit	Quantité de précipitations (équivalent liquide) qui a diminué au cours des neuf dernières heures.
pastSixHours	WeatherUnit	Quantité de précipitations (équivalent liquide) qui a diminué au cours des six dernières heures. Contient des valeurs métriques et impériales.
pastThreeHours	WeatherUnit	Quantité de précipitations (équivalent liquide) qui a chuté au cours des trois dernières heures.
pastTwelveHours	WeatherUnit	Quantité de précipitations (équivalent liquide) qui a diminué au cours des dernières 12 heures.
pastTwentyFourHours	WeatherUnit	Quantité de précipitations (équivalent liquide) qui a diminué au cours des dernières 24 heures.

PressureTendency

Nom	Type	Description
code	string	Code de tendance de pression, quelle que soit la langue. Un de F=Falling, S=Steady, R=Rising.
localizedDescription	string	Description de la tendance à la pression dans la langue spécifiée

TemperatureSummary

Nom	Type	Description
pastSixHours	PastHoursTemperature	Résumé des fluctuations de température au cours des 6 dernières heures.
pastTwelveHours	PastHoursTemperature	Résumé des fluctuations de température au cours des dernières 12 heures.
pastTwentyFourHours	PastHoursTemperature	Résumé des fluctuations de température au cours des dernières 24 heures.

UnitType

Valeur d’ID numérique associée au type d’unité affiché. Peut être utilisé pour la traduction d’unités. Pour plus d’informations, consultez Services météorologiques dans Azure Maps .

Nom	Type	Description
0	Integer
1	Integer
10	Integer
11	Integer
12	Integer
13	Integer
14	Integer
15	Integer
16	Integer
17	Integer
18	Integer
19	Integer
2	Integer
20	Integer
21	Integer
22	Integer
3	Integer
31	Integer
4	Integer
5	Integer
6	Integer
7	Integer
8	Integer
9	Integer

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.

Nom	Type	Description
imperial	string	Retourner des données en unités impériales. Quelques exemples d’unités du système impérial sont Fahrenheit et mile.
metric	string	Retourne des données en unités de métriques. Quelques exemples d’unités de système métrique sont Celsius et km.

WeatherUnit

Valeur spécifique d’une unité donnée liée à la météo.

Nom	Type	Description
unit	string	Type d’unité pour la valeur retournée.
unitType	UnitType	Valeur d’ID numérique associée au type d’unité affiché. Peut être utilisé pour la traduction d’unités. Pour plus d’informations, consultez Services météorologiques dans Azure Maps .
value	number	Valeur arrondie.

WindDetails

Détails du vent retournés, y compris la vitesse et la direction.

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

WindDirection

Sens du vent

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

Partager via