Le point de terminaison forecast:minutes fournit des prévisions de précipitations de haute résolution, minute par minute (également appelées prévisions immédiates) pour un lieu 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 au service Google Maps Platform, telles qu'acceptées par Google et vous.
1.1 Exigences d'attribution. Si le Client utilise du Contenu Google Maps provenant de l'API Weather, il doit fournir à Google une attribution conformément à la Documentation.
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 les Contenus Google Maps applicables 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 au 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 requêtes 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 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 :
Si aucun système d'unité n'est spécifié, la réponse est définie par défaut sur |
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 pour les 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 |
Période concernée par 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 :
|
segments.probability |
Probabilité de précipitations prévue pour ce segment. Les valeurs sont exprimées en 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. Voici quelques valeurs :
|
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 sur les prévisions à la 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" }, ... ] }