Obtenir des prévisions à la minute (fonctionnalité expérimentale)

Le point de terminaison forecast:minutes fournit des prévisions de précipitations haute résolution, minute par minute (également appelées prévisions immédiates) pour un emplacement donné.

L'API renvoie les informations suivantes pour une période de six heures :

  • Heure de début et de fin de la période de prédiction
  • Le fuseau horaire de l'emplacement demandé
  • Heure de début et de fin de chaque segment de prévision
  • Le type, la probabilité, la quantité et l'intensité des précipitations prévues pour chaque segment

Conditions d'utilisation

Ces conditions sont émises en vertu de la section 6 (Conditions des offres de pré-DG) des Conditions spécifiques du service Google Maps Platform, telles qu'elles ont été convenues entre Google et vous.

1.1 Exigences d'attribution. Le Client doit fournir à Google une attribution conformément à la Documentation s'il utilise du Contenu Google Maps provenant de l'API Weather.

1.2 Restrictions. Les clients ne peuvent pas utiliser le contenu Google Maps récupéré à partir de l'API Weather pour recréer un service ou un produit Google (par exemple, utiliser les données récupérées à partir de l'API Weather dans une application ou un modèle météo dont l'objectif principal est de fournir des informations météo).

1.3 Mise en cache. Les clients peuvent mettre en cache temporairement le contenu Google Maps applicable de l'API Weather pendant la période de mise en cache applicable, comme décrit dans le tableau 1.3.1 (Autorisations de mise en cache).

Tableau 1.3.1 (Autorisations de mise en cache)

Ces autorisations s'ajoutent à celles décrites dans le tableau 17.2.1 des Conditions spécifiques du service Google Maps Platform.

Contenu de Google Maps Période de mise en cache
Valeurs de prévision par minute Une heure, après quoi le Client doit supprimer le Contenu Google Maps mis en cache

À propos des demandes de prévisions à la minute

Pour demander des prévisions à la minute, envoyez une requête HTTP GET à :

https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE

Incluez les coordonnées de latitude et de longitude du lieu dans les paramètres de votre requête.

Paramètres de requête

Le point de terminaison forecast.minutes accepte les paramètres de requête suivants :

Paramètre Description Obligatoire ou facultatif
location.latitude Coordonnées de latitude de l'emplacement demandé. Obligatoire
location.longitude Coordonnées de longitude de l'emplacement demandé. Obligatoire
unitsSystem Système d'unités demandé. Voici quelques valeurs :
  • UNITS_SYSTEM_UNSPECIFIED
  • IMPERIAL
  • METRIC

Si aucun système d'unités n'est spécifié, la réponse est par défaut METRIC.

Facultatif
pageSize Spécifie le nombre maximal de résultats à renvoyer. Facultatif
pageToken Jeton de page reçu d'une requête précédente. Pour récupérer la page de données suivante, transmettez pageToken en tant que paramètre d'entrée dans la requête suivante. Facultatif

À propos des réponses aux prévisions à la minute

L'API Weather renvoie les champs suivants dans le corps de la réponse :

Champ Description
overallPredictionTimeframe La période globale des prédictions.
overallPredictionTimeframe.startTime Heure de début de la période de prédiction. Cela reflète le point de référence initial.
overallPredictionTimeframe.endTime Heure de fin de la période de prédiction. Elle est définie six heures après l'heure de début.
timeZone Fuseau horaire de l'emplacement demandé.
segments Les segments de prédiction à la minute, indiqués par timeFrame.
segments.timeFrame La période pertinente pour le segment.
segments.timeFrame.startTime Heure de début du segment.
segments.timeFrame.endTime Heure de fin du segment.
segments.type Type de précipitations prévu pendant ce segment. Voici quelques valeurs :
  • DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED
  • NONE
  • RAIN
  • SNOW
  • HAIL
segments.probability Probabilité de précipitations prévue pendant ce segment. Les valeurs sont des pourcentages compris entre 0 et 100.
segments.qpf Prévision quantitative des précipitations.
segments.qpf.quantity Quantité de précipitations prévue pendant ce segment.
segments.qpf.unit Unité utilisée pour mesurer la quantité de précipitations accumulées (par exemple, MILLIMETERS, INCHES).
segments.snowfallAmount Quantité de neige prévue pendant ce segment.
segments.snowfallAmount.quantity Quantité de neige prévue (en équivalent eau liquide) au cours de ce segment.
segments.snowfallAmount.unit Unité utilisée pour mesurer la quantité de neige accumulée (par exemple, MILLIMETERS, INCHES).
segments.intensity Intensité des précipitations du segment (PrecipitationIntensity). Les valeurs possibles sont les suivantes :
  • PRECIPITATION_INTENSITY_UNSPECIFIED
  • NO_INTENSITY
  • MID_LIGHT
  • LIGHT
  • MID_MODERATE
  • MODERATE
  • MID_HEAVY
  • HEAVY

Remarque : Assurez-vous que votre client peut gérer les valeurs inconnues.

nextPageToken Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

Exemple de prévision à la minute

L'exemple suivant demande des informations de prévision à la minute pour un emplacement en Virginie-Occidentale :

curl -H "Content-Type: application/json" -X GET "https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=37.60451&location.longitude=-80.59044&unitsSystem=METRIC&pageSize=5"

Dans la réponse, l'objet segments indique chaque segment de la période de prédiction globale :

  {
  "overallPredictionTimeframe": {
    "startTime": "2026-05-11T12:10:00Z",
    "endTime": "2026-05-11T18:12:00Z"
  },
  "timeZone": {
    "id": "America/New_York"
  },
  "segments": [
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:20:00Z",
        "endTime": "2026-05-11T12:22:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:22:00Z",
        "endTime": "2026-05-11T12:24:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    ...
  ]
}