Weather - Get Daily Forecast

Service:: Maps

Version d’API:: 1.1

Permet d’obtenir des prévisions météorologiques quotidiennes détaillées pour les 1, 5, 10, 15, 25 ou 45 prochains jours.
L’API Get Daily Forecast est une requête HTTP GET qui renvoie des prévisions météorologiques détaillées telles que la température et le vent par jour pour les 1, 5, 10, 15, 25 ou 45 prochains jours pour un emplacement de coordonnées donné. La réponse comprend des détails tels que la température, le vent, les précipitations, la qualité de l’air et l’indice UV. Pour plus d’informations, consultez la section Demander des données de prévisions météorologiques quotidiennes.

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

Avec des paramètres facultatifs:

GET {endpoint}/weather/forecast/daily/json?api-version=1.1&query={query}&unit={unit}&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.
duration	query		integer (int32)	Spécifie le nombre de jours pendant lesquels les réponses de prévision quotidiennes sont retournées. Les valeurs disponibles sont `1` - Retournez les données prévisionnelles pour le lendemain. Renvoyée par défaut. `5` - Retournez les données prévisionnelles pour les 5 prochains jours. `10` - Renvoyer les données prévisionnelles pour les 10 prochains jours. `25` - Renvoyer les données prévisionnelles pour les 25 prochains jours. `45` - Renvoyer les données prévisionnelles pour les 45 prochains jours.
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	DailyForecastResult	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 daily weather forecast for a given coordinate location

Exemple de requête

HTTP

GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5

Exemple de réponse

Code d’état:: 200

{
  "forecasts": [
    {
      "airAndPollen": [
        {
          "name": "AirQuality",
          "type": "Ozone",
          "category": "Good",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Grass",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Mold",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Ragweed",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "Tree",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        },
        {
          "name": "UVIndex",
          "category": "Low",
          "categoryValue": 1,
          "value": 0
        }
      ],
      "date": "2019-11-13T21:00:00-08:00",
      "day": {
        "cloudCover": 100,
        "hasPrecipitation": true,
        "hoursOfIce": 0,
        "hoursOfPrecipitation": 3.5,
        "hoursOfRain": 3.5,
        "hoursOfSnow": 0,
        "ice": {
          "unit": "mm",
          "unitType": 3,
          "value": 0
        },
        "iceProbability": 0,
        "iconCode": 12,
        "iconPhrase": "Showers",
        "longPhrase": "Cloudy with a couple of showers, mainly later",
        "precipitationIntensity": "Light",
        "precipitationProbability": 75,
        "precipitationType": "Rain",
        "rain": {
          "unit": "mm",
          "unitType": 3,
          "value": 6.1
        },
        "rainProbability": 75,
        "shortPhrase": "Cloudy with a few showers",
        "snow": {
          "unit": "cm",
          "unitType": 4,
          "value": 0
        },
        "snowProbability": 40,
        "thunderstormProbability": 20,
        "totalLiquid": {
          "unit": "mm",
          "unitType": 3,
          "value": 6.1
        },
        "wind": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 16.7
          }
        },
        "windGust": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 48.2
          }
        }
      },
      "degreeDaySummary": {
        "cooling": {
          "unit": "C",
          "unitType": 17,
          "value": 0
        },
        "heating": {
          "unit": "C",
          "unitType": 17,
          "value": 15
        }
      },
      "hoursOfSun": 1.1,
      "night": {
        "cloudCover": 98,
        "hasPrecipitation": true,
        "hoursOfIce": 0,
        "hoursOfPrecipitation": 2.5,
        "hoursOfRain": 2.5,
        "hoursOfSnow": 0,
        "ice": {
          "unit": "mm",
          "unitType": 3,
          "value": 0
        },
        "iceProbability": 0,
        "iconCode": 12,
        "iconPhrase": "Showers",
        "longPhrase": "Breezy this evening; otherwise, low clouds",
        "precipitationIntensity": "Light",
        "precipitationProbability": 65,
        "precipitationType": "Rain",
        "rain": {
          "unit": "mm",
          "unitType": 3,
          "value": 4
        },
        "rainProbability": 64,
        "shortPhrase": "Breezy early; cloudy",
        "snow": {
          "unit": "cm",
          "unitType": 4,
          "value": 0
        },
        "snowProbability": 40,
        "thunderstormProbability": 0,
        "totalLiquid": {
          "unit": "mm",
          "unitType": 3,
          "value": 4
        },
        "wind": {
          "direction": {
            "degrees": 181,
            "localizedDescription": "S"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 20.4
          }
        },
        "windGust": {
          "direction": {
            "degrees": 170,
            "localizedDescription": "S"
          },
          "speed": {
            "unit": "km/h",
            "unitType": 7,
            "value": 42.6
          }
        }
      },
      "realFeelTemperature": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 1.3
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": -3.4
        }
      },
      "realFeelTemperatureShade": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 1.6
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": -3.4
        }
      },
      "sources": [
        "AccuWeather"
      ],
      "temperature": {
        "maximum": {
          "unit": "C",
          "unitType": 17,
          "value": 5.3
        },
        "minimum": {
          "unit": "C",
          "unitType": 17,
          "value": 0.8
        }
      }
    }
  ],
  "summary": {
    "category": "rain",
    "endDate": "2019-11-17T15:00:00-08:00",
    "phrase": "Rain Sunday evening",
    "severity": 5,
    "startDate": "2019-11-17T09:00:00-08:00"
  }
}

Définitions

Nom	Description
AirAndPollen	Une entrée décrivant `DailyForecast.airAndPollen` un seul indicateur de pollen, de qualité de l’air ou d’indice UV pour la journée. La `name` propriété détermine quel type d’indicateur représente l’entrée : Pollen : `name` c’est l’arbre,l’herbe, l’ambroisie ou la moisissure. `value` donne le montant prévu et `category` / `categoryValue` l’évalue de Faible à Élevé. Qualité de l’air : `name` correspond à la qualité de l’air et `type` identifie le polluant mesuré ( l’un des PM2.5, PM10, O3, NO2, SO2 ou CO). `category` / `categoryValue` évaluez la qualité de l’air de Bon à Dangereux. Indice UV : `name`est UVIndex. `value` est l’indice UV (0 à 11+), et `category` / `categoryValue` évaluez le risque d’exposition de faible à extrême. `category` est l’étiquette qualitative de l’indicateur et `categoryValue` correspond à la note correspondante de 1 à 6, où 1 indique les conditions les plus sûres et 6 les plus dangereuses.
DailyForecast	La prévision pour un jour calendaire à l’emplacement spécifié, est revenue comme une entrée par jour dans le `forecasts` tableau sur `DailyForecastResult`. Inclut la plage de températures maximales/basses de la journée, les plages RealFeel (régulières et ombragées), les heures d’ensoleillement prévues, les totaux de température/refroidissement par jour, une gamme d’indicateurs de qualité de l’air, de pollen et d’indice UV, ainsi que des blocs de détails séparés pour les parties diurnes et nocturnes (précipitations, vent, couverture nuageuse, et plus encore). Le `sources` tableau liste les fournisseurs de données contribuant à la prévision.
DailyForecastDetail	Détails des prévisions pour une demi-journée. La même forme est utilisée pour les deux `DailyForecast.day` (du lever au coucher du soleil) et `DailyForecast.night` (du coucher du soleil au lever suivant), donc toutes les références à « cette période » ci-dessous désignent cette portion spécifique du jour ou de la nuit – jamais la journée complète de 24 heures. Comprend une icône de prévision et des phrases, le type / intensité / probabilités de précipitations, les totaux d’accumulation, les heures de précipitations, le vent et la couverture nuageuse.
DailyForecastResult	La réponse est revenue par l’opération Get Daily Forecast, fournissant une prévision météo jour par jour pour un lieu spécifié. Inclut un niveau `summary` supérieur décrivant les conditions dominantes et la gravité pour la fenêtre demandée, ainsi qu’un `forecasts` tableau avec une `DailyForecast` entrée par jour. Le nombre de participations correspond à celui demandé `duration` (1, 5, 10, 15, 25 ou 45 jours ; 25 et 45 nécessitent un SKU S1).
DailyForecastSummary	Un résumé général des conditions météorologiques dominantes sur une partie ou la totalité de la fenêtre de prévision quotidienne demandée. La fenêtre résumée peut être plus étroite que la demande complète – par exemple, lorsque des conditions météorologiques importantes (comme un système d’orage) ne sont attendues que sur une partie de la période – et est délimitée par `startDate` et `endDate`. Les conditions elles-mêmes sont décrites à la fois comme une forme `phrase`libre, une étiquette d’un ou deux mots `category` , et une note numérique `severity` .
DegreeDaySummary	Les totaux de degrés par jour de chauffage et de refroidissement pour un seul jour, utilisés pour estimer la demande énergétique pour le chauffage ou le refroidissement d’un bâtiment. Chaque valeur correspond au nombre de degrés par lesquels la température moyenne du jour diffère de la référence de 65°F (18°C ), dans l’unité de température spécifiée dans la demande - les degrés en dessous de la base contribuent à `heating`, les degrés au-dessus contribuent à `cooling`.
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.
LocalSource	Informations sur un fournisseur local de données météorologiques utilisé pour obtenir la prévision sur `DailyForecastDetail.localSource`. Identifie le fournisseur (`id`, `name`) et expose la native `weatherCode` du fournisseur afin que les applications puissent afficher le propre jeu d'icônes du fournisseur au lieu des icônes Azure Maps par défaut.
PrecipitationType	Spécifie le type de précipitation. Les valeurs valides sont Pluie, Neige, Glace ou Mélange. Cette propriété est incluse dans la réponse lorsque dBZ est supérieur à zéro.
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.
WeatherValueRange	Fournit les températures les plus élevées et les plus basses prévues pour la période spécifiée, mesurées en degrés Celsius (°C) ou Fahrenheit (°F), en fonction de l’unité spécifiée dans la demande.
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.

AirAndPollen

Objet

Une entrée décrivant DailyForecast.airAndPollen un seul indicateur de pollen, de qualité de l’air ou d’indice UV pour la journée. La name propriété détermine quel type d’indicateur représente l’entrée :

Pollen : name c’est l’arbre,l’herbe, l’ambroisie ou la moisissure. value donne le montant prévu et category / categoryValue l’évalue de Faible à Élevé.
Qualité de l’air : name correspond à la qualité de l’air et type identifie le polluant mesuré ( l’un des PM2.5, PM10, O3, NO2, SO2 ou CO). category / categoryValue évaluez la qualité de l’air de Bon à Dangereux.
Indice UV : nameest UVIndex. value est l’indice UV (0 à 11+), et category / categoryValue évaluez le risque d’exposition de faible à extrême.

category est l’étiquette qualitative de l’indicateur et categoryValue correspond à la note correspondante de 1 à 6, où 1 indique les conditions les plus sûres et 6 les plus dangereuses.

Nom	Type	Description
category	string	Une courte étiquette qualitative pour l’indicateur, renvoyée dans la langue spécifiée dans la demande. Les valeurs possibles dépendent de `name`: Pollen : faible, modéré, élevé ou très élevé. Qualité de l’air : Bonne, modérée, malsaine pour les groupes sensibles, malsaine, très malsaine ou dangereuse. Indice UV : faible, modéré, élevé, très élevé ou extrême.
categoryValue	integer (int32)	Une note numérique de 1 à 6 associée à `category`, où 1 indique les conditions les plus sûres et 6 les plus dangereuses. Utilisez cela lorsqu’une valeur numérique stable et indépendante de la langue est nécessaire à la place de l’étiquette localisée `category` .
name	string	Identifie quel indicateur représente cette entrée. Soit le nom d’une source de pollen (arbre, herbe, ambroisie ou moisissure), la qualité de l’air (dans ce `type` cas identifie le polluant), ou UVIndex.
type	string	Quand `name`est AirQuality, le polluant spécifique mesuré l’un de PM2.5, PM10, O3 (ozone), NO2 (dioxyde d’azote), SO2 (dioxyde de soufre) ou CO (monoxyde de carbone). Pas retourné pour les entrées de pollen ou d’indice UV.
value	integer (int32)	La mesure numérique pour cet indicateur. L’unité dépend de `name`: Pour le pollen, le comptage de prévision du pollen. Pour la qualité de l’air, la concentration de polluants en unités appropriées au polluant – généralement des microgrammes par mètre cube (μg/m³) pour les particules et des parties par milliard (ppb) pour des gaz tels que l’ozone. Pour l’indice UV, une valeur d’indice de 0 à 11+. La qualité de l’air et l’indice UV sont eux-mêmes des indices, ils sont donc rapportés comme des chiffres sans unité.

DailyForecast

Objet

La prévision pour un jour calendaire à l’emplacement spécifié, est revenue comme une entrée par jour dans le forecasts tableau sur DailyForecastResult. Inclut la plage de températures maximales/basses de la journée, les plages RealFeel (régulières et ombragées), les heures d’ensoleillement prévues, les totaux de température/refroidissement par jour, une gamme d’indicateurs de qualité de l’air, de pollen et d’indice UV, ainsi que des blocs de détails séparés pour les parties diurnes et nocturnes (précipitations, vent, couverture nuageuse, et plus encore). Le sources tableau liste les fournisseurs de données contribuant à la prévision.

Nom	Type	Description
airAndPollen	AirAndPollen[]	Prévisions de la qualité de l’air, du pollen et de l’indice UV pour la journée. Chaque entrée indique un nom (comme Arbre, Herbe, Ambroisie, Moisissure, Qualité de l’air ou UVIndex), une valeur numérique et une valeur qualitative `category` (comme Faible, Modéré, Élevé, Bonne, Malsaine ou Dangereuse) afin que les applications puissent signaler les risques potentiels pour la santé.
date	string (date-time)	La date calendaire couverte par cette prévision, au format ISO 8601 (`yyyy-mm-ddThh:mm:ss-hh:mm`). Par exemple, 2025-04-29T07:00:00-07:00.
day	DailyForecastDetail	Les prévisions détaillées pour la partie diurne de la journée – incluant la température, les précipitations, le vent, la couverture nuageuse et d’autres attributs clés.
degreeDaySummary	DegreeDaySummary	Totaux de degrés par jour de chauffage et de climatisation pour la journée, utilisés pour estimer la demande énergétique pour le contrôle climatique des bâtiments.
hoursOfSun	number (float)	Le nombre attendu d’heures d’ensoleillement durant la journée, utile pour planifier les activités de plein air et évaluer les conditions générales de la journée.
night	DailyForecastDetail	Les prévisions détaillées pour la partie nocturne de la journée - incluant la température, les précipitations, le vent, la couverture nuageuse et d’autres attributs clés.
realFeelTemperature	WeatherValueRange	Les valeurs de température RealFeel™ élevées et basses pour la journée, 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	WeatherValueRange	Les valeurs de température RealFeel™ élevées et basses pour la journée sont 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.
sources	string[]	Les fournisseurs de données qui ont contribué à la prévision de ce jour.
temperature	WeatherValueRange	Les températures atmosphériques maximales et basses prévues pour la journée, en degrés Celsius (°C) ou Fahrenheit (°F), selon l’unité spécifiée dans la demande.

DailyForecastDetail

Objet

Détails des prévisions pour une demi-journée. La même forme est utilisée pour les deux DailyForecast.day (du lever au coucher du soleil) et DailyForecast.night (du coucher du soleil au lever suivant), donc toutes les références à « cette période » ci-dessous désignent cette portion spécifique du jour ou de la nuit – jamais la journée complète de 24 heures. Comprend une icône de prévision et des phrases, le type / intensité / probabilités de précipitations, les totaux d’accumulation, les heures de précipitations, le vent et la couverture nuageuse.

Nom	Type	Description
cloudCover	integer (int32)	Le pourcentage de ciel couvert de nuages durant cette période allait de 0 (ciel dégagé) à 100 (complètement couvert). Peut être NULL.
hasPrecipitation	boolean	`true` si des précipitations (pluie, neige, grésil ou grêle) sont attendues durant cette période ; `false` sinon.
hoursOfIce	number (float)	Le nombre total d’heures durant cette période où la formation de glace est attendue.
hoursOfPrecipitation	number (float)	Le nombre total d’heures durant cette période où des précipitations (pluie, neige, grésil ou grêle) sont attendues.
hoursOfRain	number (float)	Le nombre total d’heures durant cette période où la pluie est attendue.
hoursOfSnow	number (float)	Le nombre total d’heures durant cette période où la neige est attendue.
ice	WeatherValue	La quantité d’accumulation de glace prévue durant cette période, en millimètres (mm) ou pouces (pouces), selon l’unité spécifiée dans la demande.
iceProbability	integer (int32)	La probabilité de formation de glace durant cette période, exprimée en pourcentage de 0 à 100, où 0 signifie aucune chance de glace et 100 signifie que les conditions de glace sont certaines.
iconCode	IconCode	Valeur numérique représentant une image correspondant aux conditions météorologiques prévues pour cette période, décrites par la `iconPhrase` 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.
iconPhrase	string	Une courte phrase décrivant l’icône, renvoyée dans la langue spécifiée dans la requête. Par exemple, Sunny.
localSource	LocalSource	Informations sur le fournisseur local de données météo dont le code d’icônes et le code météo ont été utilisés pour cette période, lorsque l’un a été sélectionné.
longPhrase	string	Une phrase plus longue et plus descriptive pour cette période, renvoyée dans la langue spécifiée dans la demande. Azure Maps essaie de garder cette phrase sous 100 caractères, mais certaines langues ou événements météorologiques peuvent produire une chaîne plus longue.
precipitationIntensity	string	Une brève description qualitative de l’intensité des précipitations pour cette période – par exemple, légère, modérée ou forte. Retourné dans le langage spécifié dans la requête, et seulement lorsque `hasPrecipitation` est `true`.
precipitationProbability	integer (int32)	La probabilité de précipitations durant cette période, exprimée en pourcentage de 0 à 100, où 0 signifie aucune chance de précipitations et 100 signifie que les précipitations sont certaines.
precipitationType	PrecipitationType	Le type de précipitations dominant attendu durant cette période est celui de pluie, neige, glace ou mélange. Revenu seulement lorsque `hasPrecipitation` est `true`.
rain	WeatherValue	La quantité de précipitations prévue durant cette période, en millimètres (mm) ou pouces (pouces), selon l’unité spécifiée dans la demande.
rainProbability	integer (int32)	La probabilité de pluie durant cette période, exprimée en pourcentage de 0 à 100, où 0 signifie aucune chance de pluie et 100 signifie que la pluie est certaine.
shortPhrase	string	Une courte phrase décrivant la prévision pour cette période, renvoyée dans la langue spécifiée dans la demande. Azure Maps essaie de garder cette phrase sous 30 caractères, mais certaines langues ou événements météorologiques peuvent produire une chaîne plus longue.
snow	WeatherValue	La quantité d’accumulation de neige prévue durant cette période, en centimètres (cm) ou pouces (in) selon l’unité spécifiée dans la demande.
snowProbability	integer (int32)	La probabilité de neige durant cette période, exprimée en pourcentage de 0 à 100, où 0 signifie aucune chance de neige et 100 signifie que la neige est certaine.
thunderstormProbability	integer (int32)	La probabilité d’un orage durant cette période, exprimée en pourcentage de 0 à 100, où 0 signifie aucune chance d’orage et 100 signifie qu’un orage est certain.
totalLiquid	WeatherValue	La quantité totale de précipitations liquides (comme la pluie, plus l’équivalent liquide de toute neige ou glace) attendue durant cette période, en millimètres (mm) ou pouces (pouces) selon l’unité spécifiée dans la demande.
wind	WindDetails	La vitesse et la direction prévues du vent pour cette période. La vitesse du vent 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 du vent est mesurée en degrés d’azimut, de 0° (nord vrai) à 359°, se déplaçant dans le sens des aiguilles d’une montre - l’est est à 90°, le sud à 180°, l’ouest à 270°.
windGust	WindDetails	La vitesse et la direction maximales attendues pour les rafales courtes durant cette période. Les rafales de vent sont des augmentations soudaines et brèves de la vitesse du vent qui comptent pour des activités telles que l’aviation, la voile et le cerf-volant. 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, et la direction utilise la même convention d’azimut que `wind`.

DailyForecastResult

Objet

La réponse est revenue par l’opération Get Daily Forecast, fournissant une prévision météo jour par jour pour un lieu spécifié. Inclut un niveau summary supérieur décrivant les conditions dominantes et la gravité pour la fenêtre demandée, ainsi qu’un forecasts tableau avec une DailyForecast entrée par jour. Le nombre de participations correspond à celui demandé duration (1, 5, 10, 15, 25 ou 45 jours ; 25 et 45 nécessitent un SKU S1).

Nom Type Description

forecasts

Nom	Type	Description
forecasts	DailyForecast[]	Les prévisions par jour, dans l’ordre chronologique avec une entrée par jour dans le fichier demandé `duration`. Chaque entrée rapporte `DailyForecast` les températures maximales/basses de la journée, la plage RealFeel, les heures d’ensoleillement, les totaux de température/degrés par jour, les indices d’air et de pollen, des blocs de détail distincts jour et nuit (précipitations, vent, couverture nuageuse, etc.), ainsi que les sources de données contribuant à la prévision.
summary	DailyForecastSummary	Un résumé général des conditions météorologiques dominantes sur la fenêtre de prévision demandée. Le résumé ne peut couvrir qu’une partie de la fenêtre par exemple, lorsque des conditions météorologiques importantes (comme un système d’orage) sont attendues pendant une partie de celle-ci – plutôt que pendant toute la période.

DailyForecast[]

Les prévisions par jour, dans l’ordre chronologique avec une entrée par jour dans le fichier demandé duration. Chaque entrée rapporte DailyForecast les températures maximales/basses de la journée, la plage RealFeel, les heures d’ensoleillement, les totaux de température/degrés par jour, les indices d’air et de pollen, des blocs de détail distincts jour et nuit (précipitations, vent, couverture nuageuse, etc.), ainsi que les sources de données contribuant à la prévision.

summary

DailyForecastSummary

Un résumé général des conditions météorologiques dominantes sur la fenêtre de prévision demandée. Le résumé ne peut couvrir qu’une partie de la fenêtre

par exemple, lorsque des conditions météorologiques importantes (comme un système d’orage) sont attendues pendant une partie de celle-ci – plutôt que pendant toute la période.

DailyForecastSummary

Objet

Un résumé général des conditions météorologiques dominantes sur une partie ou la totalité de la fenêtre de prévision quotidienne demandée. La fenêtre résumée peut être plus étroite que la demande complète – par exemple, lorsque des conditions météorologiques importantes (comme un système d’orage) ne sont attendues que sur une partie de la période – et est délimitée par startDate et endDate. Les conditions elles-mêmes sont décrites à la fois comme une forme phraselibre, une étiquette d’un ou deux mots category , et une note numérique severity .

Nom	Type	Description
category	string	Une étiquette d’un ou deux mots catégorisant les conditions météorologiques dominantes pour la fenêtre résumée – par exemple, Ensoleillé, Partiellement Nuageux, Pluie ou Neige.
endDate	string (date-time)	La fin de la fenêtre couverte par ce résumé, au format RFC 3339 - par exemple, 2019-10-29T07:00:00-08:00. Peut être antérieure à la fin de la fenêtre de prévision demandée si l’événement résumé se termine avant celle-ci.
phrase	string	Un bref résumé textuel libre des conditions météorologiques dominantes pour la fenêtre résumée, rendu dans la langue spécifiée dans la demande. Par exemple, attendez-vous à des averses du mardi au jeudi.
severity	integer (int32)	Une note numérique de gravité pour l’événement météorologique résumé. Des nombres plus bas (à l’exclusion de 0) indiquent une sévérité plus élevée : 0 : Inconnu 1 : Significatif 2 : Major 3 : Modéré 4 : Mineur 5 : Minimal 6 : Insignifiant 7 : Informationnel
startDate	string (date-time)	Le début de la fenêtre couverte par ce résumé, au format RFC 3339 - par exemple, 2019-10-27T19:39:57-08:00. Peut être plus tard que le début de la fenêtre de prévision demandée si l’événement résumé commence en cours de route.

DegreeDaySummary

Objet

Les totaux de degrés par jour de chauffage et de refroidissement pour un seul jour, utilisés pour estimer la demande énergétique pour le chauffage ou le refroidissement d’un bâtiment. Chaque valeur correspond au nombre de degrés par lesquels la température moyenne du jour diffère de la référence de 65°F (18°C ), dans l’unité de température spécifiée dans la demande - les degrés en dessous de la base contribuent à heating, les degrés au-dessus contribuent à cooling.

Nom	Type	Description
cooling	WeatherValue	Degrés de refroidissement (CDD) - le nombre de degrés où la température moyenne de la journée dépasse la limite de base de 65°F (18°C). Des valeurs plus élevées indiquent une demande de refroidissement plus élevée. Indiqué en degrés Celsius (°C) ou Fahrenheit (°F) selon l’unité spécifiée dans la demande.
heating	WeatherValue	Degrés de chauffage (HDD) - le nombre de degrés où la température moyenne de la journée descend en dessous de la référence de 65°F (18°C). Des valeurs plus élevées indiquent une demande de chauffage plus élevée. Indiqué en degrés Celsius (°C) ou Fahrenheit (°F) selon l’unité spécifiée dans 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

LocalSource

Objet

Informations sur un fournisseur local de données météorologiques utilisé pour obtenir la prévision sur DailyForecastDetail.localSource. Identifie le fournisseur (id, name) et expose la native weatherCode du fournisseur afin que les applications puissent afficher le propre jeu d'icônes du fournisseur au lieu des icônes Azure Maps par défaut.

Nom	Type	Description
id	integer (int32)	Un identifiant numérique qui identifie de manière unique le fournisseur de données local.
name	string	Le nom du fournisseur local de données, retourné dans la langue spécifiée dans la demande lorsque disponible ; sinon retourné en anglais ou dans la langue dans laquelle le fournisseur l’a fourni.
weatherCode	string	Le code météo natif du fournisseur pour cette prévision, adapté à la correspondance avec le propre ensemble d'icônes du fournisseur au lieu de l'Azure Maps `iconCode`par défaut.

PrecipitationType

Énumération

Spécifie le type de précipitation. Les valeurs valides sont Pluie, Neige, Glace ou Mélange. Cette propriété est incluse dans la réponse lorsque dBZ est supérieur à zéro.

Valeur	Description
Ice	Glace
Mix	Mix
Rain	Pluie
Snow	Snow

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.

WeatherValueRange

Objet

Fournit les températures les plus élevées et les plus basses prévues pour la période spécifiée, mesurées en degrés Celsius (°C) ou Fahrenheit (°F), en fonction de l’unité spécifiée dans la demande.

Nom	Type	Description
maximum	WeatherValue	Fournit la température maximale pour la période spécifiée, mesurée en degrés Celsius (°C) ou Fahrenheit (°F), en fonction de l’unité spécifiée dans la demande.
minimum	WeatherValue	Fournit la température minimale pour la période spécifiée, mesurée en degrés Celsius (°C) ou Fahrenheit (°F), en fonction de l’unité spécifiée dans la demande.

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.