Weather - Get Hourly Forecast

Service:: Maps

Version d’API:: 1.1

Permet d’obtenir des prévisions météorologiques horaires détaillées jusqu’à 24 heures ou des prévisions quotidiennes jusqu’à 10 jours.
L’API Get Hourly Forecast est un HTTP GET qui demande des prévisions météorologiques détaillées à l’heure pour les 1, 12, 24 (1 jour), 72 (3 jours), 120 (5 jours) et 240 heures (10 jours) pour l’emplacement donné des coordonnées données. L’API renvoie des détails tels que la température, l’humidité, le vent, les précipitations et l’indice ultraviolet (UV). Pour plus d’informations, voir Demander des données de prévisions météorologiques horaires.

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

Avec des paramètres facultatifs:

GET {endpoint}/weather/forecast/hourly/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)	Calendrier des prévisions météorologiques retournées. Par défaut, les données de prévision de l’heure suivante seront renvoyées. Les valeurs disponibles sont `1` - Retournez les données prévisionnelles pour l’heure suivante. Valeur par défaut. `12` - Prévisions horaires de retour pour les 12 prochaines heures. `24` - Prévisions horaires de retour pour les prochaines 24 heures. `72` - Prévisions horaires de retour pour les prochaines 72 heures (3 jours). `120` - Prévisions horaires de retour pour les 120 prochaines heures (5 jours). `240` - Prévisions horaires de retour pour les prochaines 240 heures (10 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	HourlyForecastResult	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 weather forecast by the hour

Exemple de requête

HTTP

GET https://atlas.microsoft.com/weather/forecast/hourly/json?api-version=1.1&query=47.632346,-122.138874&duration=12

Exemple de réponse

Code d’état:: 200

{
  "forecasts": [
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 3901
      },
      "cloudCover": 100,
      "date": "2019-11-14T16:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 8.4
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": true,
      "precipitationProbability": 39,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 39,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 14.1
      },
      "relativeHumidity": 72,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.4
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.9
      },
      "wind": {
        "direction": {
          "degrees": 311,
          "localizedDescription": "NW"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 3.7
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 5.6
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4054
      },
      "cloudCover": 94,
      "date": "2019-11-14T17:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7.8
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 34,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 34,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 12.8
      },
      "relativeHumidity": 73,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 12.5
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.2
      },
      "wind": {
        "direction": {
          "degrees": 281,
          "localizedDescription": "W"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 5.6
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 7.4
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4176
      },
      "cloudCover": 94,
      "date": "2019-11-14T18:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7.4
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 29,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 29,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 11.3
      },
      "relativeHumidity": 77,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 11.3
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.5
      },
      "wind": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 7.4
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4542
      },
      "cloudCover": 93,
      "date": "2019-11-14T19:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.8
      },
      "relativeHumidity": 79,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.4
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.8
      },
      "wind": {
        "direction": {
          "degrees": 169,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 7.4
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 11.1
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4389
      },
      "cloudCover": 92,
      "date": "2019-11-14T20:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.9
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.2
      },
      "relativeHumidity": 80,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.1
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.6
      },
      "wind": {
        "direction": {
          "degrees": 170,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 11.1
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4481
      },
      "cloudCover": 91,
      "date": "2019-11-14T21:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7.1
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9
      },
      "relativeHumidity": 82,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.1
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.8
      },
      "wind": {
        "direction": {
          "degrees": 170,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4481
      },
      "cloudCover": 92,
      "date": "2019-11-14T22:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7.2
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "relativeHumidity": 84,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.8
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.6
      },
      "wind": {
        "direction": {
          "degrees": 174,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 3688
      },
      "cloudCover": 94,
      "date": "2019-11-14T23:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 7
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "relativeHumidity": 82,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.8
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "wind": {
        "direction": {
          "degrees": 175,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 2926
      },
      "cloudCover": 97,
      "date": "2019-11-15T00:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.9
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 20,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 20,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.8
      },
      "relativeHumidity": 81,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 10.1
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.6
      },
      "wind": {
        "direction": {
          "degrees": 176,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 2164
      },
      "cloudCover": 99,
      "date": "2019-11-15T01:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.8
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 21,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 21,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "relativeHumidity": 81,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.9
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "wind": {
        "direction": {
          "degrees": 177,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 1737
      },
      "cloudCover": 100,
      "date": "2019-11-15T02:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.8
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 21,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 21,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.5
      },
      "relativeHumidity": 82,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.8
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.4
      },
      "wind": {
        "direction": {
          "degrees": 172,
          "localizedDescription": "S"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    },
    {
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 1311
      },
      "cloudCover": 100,
      "date": "2019-11-15T03:00:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 6.9
      },
      "hasPrecipitation": false,
      "ice": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "iceProbability": 0,
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "isDaylight": false,
      "precipitationProbability": 26,
      "rain": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "rainProbability": 26,
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.6
      },
      "relativeHumidity": 83,
      "snow": {
        "unit": "cm",
        "unitType": 4,
        "value": 0
      },
      "snowProbability": 0,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 9.7
      },
      "totalLiquid": {
        "unit": "mm",
        "unitType": 3,
        "value": 0
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 16.1
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 8.4
      },
      "wind": {
        "direction": {
          "degrees": 161,
          "localizedDescription": "SSE"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 9.3
        }
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 13
        }
      }
    }
  ]
}

Définitions

Nom	Description
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.).
HourlyForecast	L’objet `HourlyForecast` fournit des détails météorologiques horaires, notamment la date et l’heure, les températures attendues et perçues, ainsi que le point de rosée. Il couvre la vitesse et la direction du vent, les rafales de vent, l’humidité relative, la visibilité et la probabilité de précipitations. Il indique si des précipitations sont attendues et précise son type. D’autres propriétés incluent l’indice UV, le pourcentage de couverture nuageuse et la hauteur du plafond nuageux. Il comporte également un code d’icônes et une phrase décrivant les conditions météorologiques.
HourlyForecastResult	La réponse est revenue par l’opération Get Hourly Forecast, contenant des prévisions météorologiques heure par heure pour un lieu spécifié. Le nombre d’entrées `HourlyForecast` retournées correspond à la durée prévue demandée - une de 1, 12, 24, 48, 72 ou 96 heures (voir l’union `HourlyDuration` ).
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.
UnitType	Une valeur entière associée au type d’unité affichée. Par exemple, 17 pour Celsius, 18 pour Fahrenheit. Peut être utilisé pour la traduction unitaire. Pour plus d’informations, voir Services météorologiques en Azure Maps.
WeatherDataUnit	Précise s’il faut retourner les données en unités métriques ou impériales, avec métrique comme valeur par défaut. Par exemple: Métrique : millimètre (mm), mètre (m), kilomètre (km), Celsius (C) Impérial : pouce (pouce), pied (pied), mile (mi), Fahrenheit (F)
WeatherValue	Valeurs pour les indicateurs météorologiques tels que la température, le point de rosée et la vitesse du vent, présentées en unités métriques ou impériales, telles que spécifiées dans le paramètre unité URI. Pour plus d’informations, voir Types d’unités dans l’article Services météo dans Azure Maps.
WindDetails	Fournit la vitesse du vent prévue, mesurée en unités telles que les kilomètres par heure (km/h) ou les miles par heure (mph), selon l’unité spécifiée dans la demande. Indique également la direction du vent mesurée en degrés d’azimut, en commençant au nord véritable et se déplaçant dans le sens des aiguilles d’une montre. Le nord correspond à 0°, l’est à 90°, le sud à 180°, et l’ouest à 270°. Les valeurs possibles varient de 0° à 359°.
WindDirection	Fournit des détails sur la direction du vent, y compris la direction en degrés d’azimut et une abréviation localisée de la direction du vent.

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.

HourlyForecast

Objet

L’objet HourlyForecast fournit des détails météorologiques horaires, notamment la date et l’heure, les températures attendues et perçues, ainsi que le point de rosée. Il couvre la vitesse et la direction du vent, les rafales de vent, l’humidité relative, la visibilité et la probabilité de précipitations. Il indique si des précipitations sont attendues et précise son type. D’autres propriétés incluent l’indice UV, le pourcentage de couverture nuageuse et la hauteur du plafond nuageux. Il comporte également un code d’icônes et une phrase décrivant les conditions météorologiques.

Nom	Type	Description
ceiling	WeatherValue	La hauteur de la couche la plus basse de nuages au-dessus du sol, mesurée en pieds ou mètres selon l’unité spécifiée dans la demande. Cette mesure est cruciale pour la prévision de l’aviation et de la météo.
cloudCover	integer (int32)	Le pourcentage du ciel couvert de nuages à l’heure spécifiée. Cette valeur varie de 0% (ciel dégagé) à 100% (complètement couvert). Peut être NULL.
date	string (date-time)	Date et heure de la prévision au format RFC 3339 (yyyy-mm-ddThh :mm :ss±hh :mm). Par exemple, 2019-11-14T16:00:00-08:00.
dewPoint	WeatherValue	La température à laquelle l’air devient saturé d’humidité et de rosée commence à se former. Il est mesuré en degrés Fahrenheit (°F) ou Celsius (°C), selon l’unité spécifiée. Cette valeur est cruciale pour comprendre les niveaux d’humidité, car un point de rosée plus élevé indique plus d’humidité dans l’air, ce qui donne une impression d’humidité accrue.
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.
ice	WeatherValue	Restitue l’accumulation estimée de glace pour chaque heure dans la prévision, mesurée en millimètres (mm) ou pouces (pouces), selon l’unité spécifiée dans la demande.
iceProbability	integer (int32)	Montre la probabilité de formation de glace durant l’heure spécifiée, exprimée en pourcentage de 0 à 100. Une valeur de 0 signifie qu’aucune chance de formation de glace, tandis que 100 signifie que la formation de glace est certaine. Ces informations aident les utilisateurs à évaluer le potentiel de conditions glacées.
iconCode	IconCode	Une valeur numérique correspondant à une image affichant le `iconPhrase`. Pour plus d’informations, voir Services météorologiques en Azure Maps.
iconPhrase	string	Un terme descriptif correspondant à une condition météorologique spécifique, comme Ensoleillé. Il est associé à un `iconCode`, qui est une valeur numérique représentant une image représentant visuellement la condition météorologique décrite par le `iconPhrase`. Pour plus d’informations, voir Services météorologiques en Azure Maps.
isDaylight	boolean	Une valeur booléenne qui indique s’il fait jour à l’heure spécifiée. Retour vrai s’il fait jour, sinon faux.
precipitationProbability	integer (int32)	Montre la probabilité de précipitations durant l’heure spécifiée, exprimée en pourcentage de 0 à 100. Une valeur de 0 signifie aucune chance de précipitations, tandis que 100 signifie que les précipitations sont certaines. Cela aide les utilisateurs à évaluer la probabilité de pluie, de neige ou d’autres formes de précipitations.
rain	WeatherValue	Indique la quantité de précipitations prévue pour chaque heure, mesurée en millimètres (mm) ou pouces (pouces), selon l’unité spécifiée dans la demande.
rainProbability	integer (int32)	Montre la probabilité de pluie pendant la période spécifiée, exprimée en pourcentage de 0 à 100. Une valeur de 0 signifie aucune chance de pluie, tandis que 100 signifie que la pluie est certaine.
realFeelTemperature	WeatherValue	Fournit les valeurs de température RealFeel™ pour l’heure spécifiée, mesurées en degrés Celsius (°C) ou Fahrenheit (°F), selon l’unité spécifiée dans la demande. Cette métrique, développée par AccuWeather, intègre plus d’une douzaine de facteurs, dont l’humidité, la vitesse du vent, la couverture nuageuse et l’intensité solaire, afin d’offrir une mesure complète de la sensation réelle du temps. Pour plus d’informations, consultez : Quelle est la température AccuWeather RealFeel ?
relativeHumidity	integer (int32)	La quantité de vapeur d’eau présente dans l’air, exprimée en pourcentage de la quantité maximale que l’air peut contenir à la même température. Cette valeur indique à quel point l’air est proche d’être saturé d’humidité, ce qui influence le confort ou l’humidité de l’environnement.
snow	WeatherValue	Restitue la quantité d’accumulation de neige prévue durant l’heure spécifiée, mesurée en millimètres (mm) ou pouces (pouces), selon l’unité spécifiée dans la demande.
snowProbability	integer (int32)	Montre la probabilité de neige pendant l’heure spécifiée, exprimée en pourcentage de 0 à 100. Une valeur de 0 signifie aucune chance de neige, tandis que 100 signifie que la neige est certaine.
temperature	WeatherValue	La température attendue pour l’heure spécifiée, mesurée en degrés Celsius (°C) ou Fahrenheit (°F), selon l’unité spécifiée dans la demande.
totalLiquid	WeatherValue	Restitue la quantité totale de précipitations liquides (comme la pluie) attendue à chaque heure de la période de prévision, mesurée en millimètres (mm) ou pouces (pouces), selon l’unité spécifiée dans la demande.
uvIndex	integer (int32)	Fournit l’indice ultraviolet (UV) pour chaque heure de la période de prévision. Cet indice indique le niveau de rayonnement ultraviolet attendu, aidant les utilisateurs à comprendre le risque potentiel d’exposition au soleil à différents moments de la journée. 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 à une exposition solaire non protégée. 6-7 : Risque élevé de dommages dus à une exposition non protégée au soleil. 8-10 : Risque très élevé de dommages dus à une exposition non protégée au soleil. 11+ : Risque extrême de dommages dus à une exposition non protégée au soleil.
uvIndexPhrase	string	Fournit une expression descriptive indiquant le niveau de rayonnement UV, tel que Faible, Modéré, Élevé ou Très Élevé.
visibility	WeatherValue	Rend la distance à laquelle un objet ou une lumière peut être clairement discernée pour chaque heure de la période de prévision, mesurée en kilomètres (km) ou miles (mi), selon l’unité spécifiée dans la demande. Cela indique à quelle distance on peut clairement voir, ce qui est crucial pour des activités comme la conduite et l’aviation.
wetBulbTemperature	WeatherValue	Ça rend la température qu’un paquet d’air aurait s’il était refroidi à la saturation (100% humidité relative) par l’évaporation de l’eau à son intérieur. Cette propriété est importante pour comprendre la contrainte thermique et l’effet de refroidissement de l’évaporation.
wind	WindDetails	Fournit la vitesse et la direction du vent attendues. La vitesse du vent est mesurée en kilomètres par heure (km/h) ou en miles par heure (mph), selon l’unité spécifiée. La direction du vent est mesurée en degrés d’azimut, allant 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	Indique la vitesse maximale attendue des rafales de vent à chaque heure de la période de prévision, mesurée en kilomètres par heure (km/h) ou miles par heure (mph), selon l’unité spécifiée. La direction du vent est donnée en degrés d’azimut, allant de 0° (nord vrai) à 359°, se déplaçant dans le sens des aiguilles d’une montre. Les rafales de vent sont des augmentations brèves de la vitesse du vent, importantes pour comprendre les variations à court terme pouvant impacter des activités telles que l’aviation, la voile et les événements en plein air.

HourlyForecastResult

Objet

La réponse est revenue par l’opération Get Hourly Forecast, contenant des prévisions météorologiques heure par heure pour un lieu spécifié. Le nombre d’entrées HourlyForecast retournées correspond à la durée prévue demandée - une de 1, 12, 24, 48, 72 ou 96 heures (voir l’union HourlyDuration ).

Nom	Type	Description
forecasts	HourlyForecast[]	Les entrées de prévision heure par heure, une par heure dans la fenêtre demandée, dans l’ordre chronologique. Chaque entrée contient la température attendue, le RealFeel, le point de rosée, le vent, les prévisions de précipitations (probabilité et quantités de pluie, neige et glace), la couverture nuageuse, la visibilité, l’indice UV, le plafond et d’autres observations pour cette heure. Par exemple, une durée de 12 rend 12 entrées à partir de 2019-11-14T16:00:00-08:00 et avancent d’une heure à la fois.

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

UnitType

Énumération

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

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

WeatherDataUnit

Énumération

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

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

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

WeatherValue

Objet

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

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

WindDetails

Objet

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

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

WindDirection

Objet

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

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