Weather - Get Minute Forecast

Permet d’obtenir une prévision minute par minute pour les 120 prochaines minutes à des intervalles de 1, 5 et 15 minutes.
L’API Get Minute Forecast est une requête HTTP GET qui renvoie des prévisions minute par minute pour un emplacement donné pour les 120 prochaines minutes. Les utilisateurs peuvent demander des prévisions météorologiques par intervalles de 1, 5 et 15 minutes. La réponse comprendra des détails tels que le type de précipitation (y compris la pluie, la neige ou un mélange des deux), l’heure de début et la valeur de l’intensité des précipitations (dBZ). Pour plus d’informations, voir Demander des données de prévisions météorologiques minute par minute.

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

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

Paramètres URI

En-tête de la demande

Réponses

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.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

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 minute-by-minute forecasts for a given location

GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query=47.632346,-122.138874&interval=15

{
  "intervalSummaries": [
    {
      "briefPhrase": "Rain ending in %minute_value min",
      "endMinute": 24,
      "iconCode": 12,
      "longPhrase": "Rain ending in %minute_value min",
      "shortPhrase": "Rain ending in %minute_value min",
      "startMinute": 0,
      "totalMinutes": 25
    },
    {
      "briefPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "endMinute": 119,
      "iconCode": 7,
      "longPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "shortPhrase": "No precip for %MINUTE_VALUE min",
      "startMinute": 25,
      "totalMinutes": 95
    }
  ],
  "intervals": [
    {
      "cloudCover": 100,
      "color": {
        "blue": 2,
        "green": 98,
        "hex": "#086202",
        "red": 8
      },
      "dbz": 23,
      "iconCode": 12,
      "minute": 0,
      "precipitationType": "Rain",
      "shortPhrase": "Light Rain",
      "simplifiedColor": {
        "blue": 39,
        "green": 190,
        "hex": "#23BE27",
        "red": 35
      },
      "startTime": "2019-11-14T15:18:00-08:00",
      "threshold": "LIGHT"
    },
    {
      "cloudCover": 100,
      "color": {
        "blue": 9,
        "green": 133,
        "hex": "#208509",
        "red": 32
      },
      "dbz": 18,
      "iconCode": 12,
      "minute": 15,
      "precipitationType": "Rain",
      "shortPhrase": "Light Rain",
      "simplifiedColor": {
        "blue": 39,
        "green": 190,
        "hex": "#23BE27",
        "red": 35
      },
      "startTime": "2019-11-14T15:33:00-08:00",
      "threshold": "LIGHT"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 30,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T15:48:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 45,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:03:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 60,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:18:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 75,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:33:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 90,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:48:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 105,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T17:03:00-08:00"
    }
  ],
  "summary": {
    "briefPhrase": "Rain ending in 25 min",
    "briefPhrase60": "Rain ending in 25 min",
    "iconCode": 12,
    "longPhrase": "Rain ending in 25 min",
    "shortPhrase": "Rain ending in 25 min"
  }
}

Définitions

ColorValue

Une couleur RVB, retournée à la fois sous forme composante (red, green, blue) et hexadécimale (hex). Utilisé par la prévision minute par minute pour rendre chaque intervalle sur un affichage de type radar - voir ForecastInterval.color pour la couleur à spectre complet mappée à dbz, et ForecastInterval.simplifiedColor pour la couleur plus grossière dérivée de precipitationType et threshold. Pour les correspondances de couleurs sous-jacentes, voir Services météo dans Azure Maps.

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.).

ForecastInterval

Représente une tranche temporelle unique dans une prévision minute par minute, décrivant les conditions météorologiques attendues durant cet intervalle. Chaque intervalle couvre 1, 5 ou 15 minutes – selon la résolution demandée – et comprend l’heure de départ, l’intensité des précipitations (dbz), le type et le seuil de précipitations, une courte phrase descriptive, un code d’icône, la couverture nuageuse, ainsi que les couleurs à spectre complet et simplifiées utilisées pour représenter visuellement les conditions sur un affichage de type radar.

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.

IntervalSummary

Décrit les prévisions météorologiques pour une fenêtre contiguë à l’intérieur de la prévision minute par minute – généralement une période de conditions similaires, comme la pluie se terminant dans 25 minutes ou la neige légère commençant dans 10 minutes. Chaque résumé spécifie la fenêtre en minutes à partir du début de la prévision (startMinute, endMinute, totalMinutes), fournit des descriptions de phrases en trois longueurs (courte, brève et longue) afin que le niveau de détail approprié puisse être affiché pour l’espace utilisateur disponible, et inclut une iconCode pour l’icône météo représentative. A MinuteForecastResult renvoie une ou plusieurs IntervalSummary entrées qui couvrent ensemble la période de prévision.

JsonFormat

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

MinuteForecastResult

La réponse est revenue par l’opération Get Minute Forecast, fournissant une prévision des précipitations minute par minute pour un lieu spécifié sur les 120 minutes suivantes à la résolution demandée (1, 5 ou 15 minutes). La réponse est organisée en trois couches : une liste globale summary avec des descriptions de phrases et une icône représentative pour toute la période ; un intervalSummaries tableau qui regroupe les minutes consécutives en longues périodes de conditions similaires (comme la pluie se terminant en 25 minutes) ; et un intervals tableau contenant les points de prévision détaillés par minute, incluant l’intensité des précipitations (dbz), le type de précipitations, la couverture nuageuse et les couleurs utilisées pour rendre les visualisations de type radar.

MinuteForecastSummary

Fournit des résumés de phrases décrivant les prévisions de précipitations pour la prochaine période de prévision, minute par minute. Plusieurs longueurs de phrases sont incluses – courte (~25 caractères), brève (~60 caractères) et longue (60+ caractères) – afin que les applications puissent afficher le niveau de détail qui correspond le mieux à l’espace disponible de l’interface. An iconCode indique l’icône météo représentative de la période.

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.