Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

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 :

Heures de début et de fin de la période de prédiction
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é-disponibilité générale) des Conditions spécifiques aux services Google Maps Platform, telles qu'acceptées par 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éorologiques).

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 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 par minute

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

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 de l'emplacement dans les paramètres de votre demande.

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 du lieu 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 de prévisions à la minute

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

Champ	Description
`overallPredictionTimeframe`	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`	Segments de prédiction au niveau de 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 pour cette période. Les valeurs sont des pourcentages compris entre 0 et 100.
`segments.qpf`	Prévisions quantitatives 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 au cours de 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. Voici quelques valeurs : `PRECIPITATION_INTENSITY_UNSPECIFIED` `NO_INTENSITY` `LIGHT` `MODERATE` `HEAVY`
`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évisions à la minute

L'exemple suivant demande des informations de prévision par minute pour un lieu 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"
    },
    ...
  ]
}