Weather - Get Current Conditions

Service:: Maps

Version de l’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 https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query={query}

Avec paramètres optionnels:

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

Paramètres d’URI

Nom	Dans	Obligatoire	Type	Description
format	path	True	JsonFormat	Format souhaité de la réponse. Seul `json` format 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 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	Calendrier des conditions météorologiques retournées. Par défaut, les conditions météorologiques les plus récentes seront renvoyées. La 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 à partir de l’API de compte du plan de gestion Azure Maps. Pour plus d’informations sur l’utilisation de la sécurité Microsoft Entra ID dans Azure Maps, consultez Gérer l’authentification dans Azure Maps.

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 Microsoft Entra OAuth 2.0. Lorsqu’il est associé à 'accès en fonction du rôle Azure contrôle, 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 Azure Maps ou sous-ressources. 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.

Notes

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. Vous pouvez l’acquérir à partir de l’API de gestion Maps.

La 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 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
Couler: 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 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: 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, 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

Demande d’échantillon

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
        },
        "past3Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past6Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past9Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past12Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past18Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "past24Hours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        }
      },
      "temperatureSummary": {
        "past6Hours": {
          "minimum": {
            "value": 8.3,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "past12Hours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "past24Hours": {
          "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 correspond aux conditions météorologiques actuelles décrites par la `Phrase` propriété. Pour plus d’informations, consultez Services météo dans 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
PressureTendency
TemperatureSummary
UnitType	Entier représentant le type d’unité. Par exemple, 17 pour Celsius, 18 pour Fahrenheit. Peut être utilisé pour la traduction unitaire. Pour obtenir la liste complète, consultez Services météo 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 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

Nom	Type	Description
apparentTemperature	WeatherUnit	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	WeatherUnit	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	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	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 (int32)	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, consultez Services météo dans 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	WeatherUnit	Écart par rapport à la température observée il y a 24 heures dans l’unité spécifiée.
phrase	string	Description de phrase 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	WeatherUnit	Pression atmosphérique dans l’unité spécifiée.
pressureTendency	PressureTendency	Changement de pression atmosphérique.
realFeelTemperature	WeatherUnit	RealFeel™ Temperature en cours de retour.
realFeelTemperatureShade	WeatherUnit	RealFeel™ Temperature en cours de retour. Décrit ce que l’on ressent vraiment à l’ombre lorsqu’il fait l’objet.
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	WeatherUnit	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	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 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	WeatherUnit	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

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

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, consultez Services météo dans 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)
9
10
11	Fog
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	Rain
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	Ice
25	Sleet
26	Pluie verglaçante
27
28
29	Pluie et neige
30	Hot
31	Cold
32	Windy
33	Clear
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	WeatherUnit	maximum
minimum	WeatherUnit	minimum

PrecipitationSummary

Objet

Nom	Type	Description
past12Hours	WeatherUnit	La quantité de précipitations (équivalent liquide) qui est tombée au cours des 12 dernières heures.
past18Hours	WeatherUnit	La quantité de précipitations (équivalent liquide) qui a chuté au cours des 18 dernières heures.
past24Hours	WeatherUnit	La quantité de précipitations (équivalent liquide) qui a chuté au cours des dernières 24 heures.
past3Hours	WeatherUnit	La quantité de précipitations (équivalent liquide) qui a chuté au cours des trois dernières heures.
past6Hours	WeatherUnit	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	WeatherUnit	La quantité de précipitations (équivalent liquide) qui a chuté au cours des neuf dernières heures.
pastHour	WeatherUnit	La quantité de précipitations (équivalent liquide) qui sont tombées au cours de la dernière heure.

PressureTendency

Objet

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

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 obtenir la liste complète, consultez Services météo dans 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	float
22	integer
31	MicrogramsPerCubicMeterOfAir

WeatherDataUnit

Énumération

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.

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.

WeatherUnit

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 (int32)	Entier représentant le type d’unité. Par exemple, 17 pour Celsius, 18 pour Fahrenheit. Peut être utilisé pour la traduction unitaire. Pour obtenir la liste complète, consultez Services météo dans 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	WeatherUnit	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.

Partager via

Weather - Get Current Conditions

Paramètres d’URI

En-tête de la demande

Réponses

Sécurité

AADToken

Notes

Étendues

subscription-key

SAS Token

Exemples

Successfully retrieve detailed current weather conditions for a given coordinate location

Demande d’échantillon

Exemple de réponse

Définitions

CurrentConditions

CurrentConditionsResult

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IconCode

JsonFormat

PastHoursTemperature

PrecipitationSummary

PressureTendency

TemperatureSummary

UnitType

WeatherDataUnit

WeatherUnit

WindDetails

WindDirection