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 lieu 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
- Fuseau horaire du lieu demandé
- Heure de début et de fin de chaque segment de prévision
- Type, probabilité, quantité et intensité de précipitations prévus pour chaque segment
Conditions d'utilisation
Ces conditions sont émises conformément à la section 6 (Conditions des offres avant disponibilité générale) 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 une attribution à Google en conformité avec la documentation s'il utilise du contenu Google Maps à partir 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 à partir 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 à la minute | Une heure, après quoi le client doit supprimer le contenu Google Maps mis en cache |
À propos des requêtes de prévisions à la 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 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 du lieu demandé. | Obligatoire |
location.longitude |
Coordonnées de longitude du lieu demandé. | Obligatoire |
unitsSystem |
Système d'unités demandé. Les valeurs incluent :
Si aucun système d'unités 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 |
Jetons de page reçus 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évisions. |
overallPredictionTimeframe.startTime |
Heure de début de la période de prédiction. Il s'agit du 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 du lieu demandé. |
segments |
Segments de prédiction au niveau de la minute, indiqués par timeFrame. |
segments.timeFrame |
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 pour ce segment. Les valeurs incluent :
|
segments.probability |
Probabilité de précipitations prévue pour ce segment. Les valeurs sont exprimées en pourcentage, de 0 à 100. |
segments.qpf |
Prévisions quantitatives de précipitations. |
segments.qpf.quantity |
Quantité de précipitations prévue pour 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 pour ce segment. |
segments.snowfallAmount.quantity |
Quantité de neige prévue (en équivalent eau liquide) pour 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. Les valeurs incluent :
|
nextPageToken |
Jetons pouvant être envoyés 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 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" }, ... ] }