L'endpoint forecast:minutes fornisce previsioni di precipitazioni ad alta risoluzione, minuto per minuto (note anche come nowcasting) per una determinata località.
L'API restituisce le seguenti informazioni per un periodo di 6 ore:
- La data/ora di inizio e di fine del periodo di previsione
- Il fuso orario della posizione richiesta
- L'ora di inizio e di fine di ogni segmento di previsione
- Il tipo, la probabilità, la quantità e l'intensità delle precipitazioni previste durante ogni segmento
Termini
Questi termini sono emessi ai sensi della Sezione 6 (Termini delle offerte pre-GA) dei Termini specifici di servizio di Google Maps Platform, come concordato da Google e dall'utente.
1.1 Requisiti di attribuzione. Se il Cliente utilizza i contenuti di Google Maps dell'API Weather, deve fornire l'attribuzione a Google in conformità alla Documentazione.
1.2 Limitazioni. I clienti non possono utilizzare i contenuti di Google Maps recuperati dall'API Weather per ricreare un servizio o un prodotto Google (ad es. utilizzare i dati recuperati dall'API Weather in un'app meteo o in un modello meteo il cui scopo principale è fornire informazioni meteo).
1.3 Memorizzazione nella cache. I clienti possono memorizzare temporaneamente nella cache i Contenuti di Google Maps applicabili dell'API Weather per il Periodo di memorizzazione nella cache applicabile, come descritto nella Tabella 1.3.1 (Autorizzazioni di memorizzazione nella cache).
Tabella 1.3.1 (autorizzazioni di memorizzazione nella cache)
Queste autorizzazioni si aggiungono a quelle descritte nella Tabella 17.2.1 dei Termini specifici di servizio di Google Maps Platform.
| Contenuti di Google Maps | Periodo di memorizzazione nella cache |
|---|---|
| Valori di previsione al minuto | Un'ora, dopodiché il Cliente deve eliminare i Contenuti di Google Maps memorizzati nella cache |
Informazioni sulle richieste di previsione al minuto
Per richiedere previsioni al minuto, invia una richiesta GET HTTP a:
https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE
Includi le coordinate di latitudine e longitudine della posizione nei parametri della richiesta.
Parametri di richiesta
L'endpoint forecast.minutes accetta i seguenti parametri di richiesta:
| Parametro | Descrizione | Obbligatorio o facoltativo |
|---|---|---|
location.latitude |
Le coordinate di latitudine della posizione richiesta. | Obbligatorio |
location.longitude |
Le coordinate di longitudine della località richiesta. | Obbligatorio |
unitsSystem |
Il sistema di unità richiesto. I valori includono:
Se non viene specificato alcun sistema di unità, la risposta utilizza per impostazione predefinita |
Facoltativo |
pageSize |
Specifica il numero massimo di risultati da restituire. | Facoltativo |
pageToken |
Un token di pagina ricevuto da una richiesta precedente. Per recuperare la pagina successiva di dati, trasmetti pageToken come parametro di input nella richiesta successiva. |
Facoltativo |
Informazioni sulle risposte di previsione al minuto
L'API Weather restituisce i seguenti campi nel corpo della risposta:
| Campo | Descrizione |
|---|---|
overallPredictionTimeframe |
Il periodo di tempo complessivo per le previsioni. |
overallPredictionTimeframe.startTime |
L'ora di inizio del periodo di previsione. Questo riflette il punto di riferimento iniziale. |
overallPredictionTimeframe.endTime |
L'ora di fine del periodo di previsione. Questo valore viene impostato sei ore dopo l'ora di inizio. |
timeZone |
Il fuso orario della posizione richiesta. |
segments |
I segmenti di previsione a livello di minuti, indicati da timeFrame. |
segments.timeFrame |
Il periodo di tempo pertinente al segmento. |
segments.timeFrame.startTime |
L'ora di inizio del segmento. |
segments.timeFrame.endTime |
L'ora di fine del segmento. |
segments.type |
Il tipo di precipitazione previsto durante il segmento. I valori includono:
|
segments.probability |
La probabilità prevista di precipitazioni durante il segmento. I valori sono espressi in percentuali comprese tra 0 e 100. |
segments.qpf |
La previsione quantitativa delle precipitazioni. |
segments.qpf.quantity |
La quantità prevista di precipitazioni durante il segmento. |
segments.qpf.unit |
L'unità utilizzata per misurare la quantità di precipitazioni accumulate (ad esempio, MILLIMETERS, INCHES). |
segments.snowfallAmount |
La quantità di neve prevista durante il segmento. |
segments.snowfallAmount.quantity |
La quantità di neve prevista (come equivalente di acqua liquida) durante il segmento. |
segments.snowfallAmount.unit |
L'unità utilizzata per misurare la quantità di neve accumulata (ad esempio MILLIMETERS, INCHES). |
segments.intensity |
L'intensità delle precipitazioni del segmento. I valori includono:
|
nextPageToken |
Un token che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine. |
Esempio di previsione al minuto
L'esempio seguente richiede informazioni sulle previsioni al minuto per una località in West Virginia:
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"
Nella risposta, l'oggetto segments indica ogni segmento del periodo di previsione complessivo:
{ "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" }, ... ] }