Weather - Get Hourly Forecast

Service:: Maps

Version de l’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.

Si vous utilisez le niveau tarifaire Gen1 S0, vous pouvez demander des prévisions horaires pour les 1, 12, 24 heures (1 jour) et 72 heures (3 jours) suivantes. Si vous utilisez le niveau tarifaire Gen1 S1 ou Gen2, vous pouvez également demander des prévisions horaires pour les 120 (5 jours) et les 240 prochaines heures (10 jours).

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

Avec paramètres optionnels:

GET https://atlas.microsoft.com/weather/forecast/hourly/json?api-version=1.1&query={query}&unit={unit}&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.
duration	query		integer	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). Disponible uniquement en SKU S1. `240` - Prévisions horaires de retour pour les prochaines 240 heures (10 jours). Disponible uniquement en SKU S1.
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	HourlyForecastResult	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 mettre en œuvre des scénarios, nous vous recommandons d’afficher les concepts d’authentification. En résumé, cette définition de sécurité fournit une solution pour 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 à quelle ressource Azure Maps l’application demande l’accès. Celui-ci peut être acquis à partir de l’API de gestion de 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 weather forecast by the hour

Demande d’échantillon

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

Définitions

Nom	Description
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
HourlyForecast
HourlyForecastResult
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.
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

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.

HourlyForecast

Objet

Nom	Type	Description
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.
date	string (date-time)	Date et heure de la prévision 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.
ice	WeatherUnit	Ice
iceProbability	integer (int32)	Pourcentage représentant la probabilité de neige. Par exemple, « 5 ».
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.
iconPhrase	string	Description de la phrase de l’icône météo.
isDaylight	boolean	Spécifie s’il fait jour ou non. True indique la lumière du jour.
precipitationProbability	integer (int32)	Pourcentage représentant la probabilité de précipitations. Par exemple, '20'.
rain	WeatherUnit	Rain
rainProbability	integer (int32)	Pourcentage représentant la probabilité de pluie. Par exemple, '50'.
realFeelTemperature	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.
snow	WeatherUnit	Snow
snowProbability	integer (int32)	Pourcentage représentant la probabilité de neige. Par exemple, '50'.
temperature	WeatherUnit	Température en cours de retour.
totalLiquid	WeatherUnit	Équivalent liquide total des précipitations au cours de la période de prévision.
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.
windGust	WindDetails	Rafale de vent. Une rafale de vent est une augmentation soudaine et brève de la vitesse du vent.

HourlyForecastResult

Objet

Nom	Type	Description
forecasts	HourlyForecast[]	Données prévisionnelles pour chaque heure renvoyée.

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

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 Hourly Forecast

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 weather forecast by the hour

Demande d’échantillon

Exemple de réponse

Définitions

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

HourlyForecast

HourlyForecastResult

IconCode

JsonFormat

UnitType

WeatherDataUnit

WeatherUnit

WindDetails

WindDirection