Ottieni una chiave demo di Maps: prova l'API Weather senza costi con una chiave demo di Maps, senza bisogno di dati di fatturazione.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Visualizzare le previsioni al minuto (sperimentale)

L'endpoint forecast:minutes fornisce previsioni delle 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 tempo di 6 ore:

La data/ora di inizio e di fine del periodo di tempo della previsione
Il fuso orario della località 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

I presenti termini vengono emessi ai sensi della Sezione 6 (Termini delle Offerte pre-GA) dei Termini di servizio specifici di Google Maps Platform, come concordato tra Google e l'utente.

1.1 Requisiti di attribuzione. Il Cliente deve fornire l'attribuzione a Google in conformità alla Documentazione se utilizza i Contenuti di Google Maps dell'API Weather.

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 esempio, utilizzare i dati recuperati dall'API Weather in un'app o un modello meteorologico il cui scopo principale è fornire informazioni meteorologiche).

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 dei servizi 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 località 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 località richiesta.	Obbligatorio
`location.longitude`	Le coordinate di longitudine della località richiesta.	Obbligatorio
`unitsSystem`	Il sistema di unità richiesto. I valori includono: `UNITS_SYSTEM_UNSPECIFIED` `IMPERIAL` `METRIC` Se non viene specificato alcun sistema di unità, la risposta predefinita è `METRIC`.	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 di dati successiva, passa `pageToken` come parametro di input nella richiesta successiva.	Facoltativo

Informazioni sulle risposte alle previsioni 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 tempo della previsione. Questo riflette il punto di riferimento iniziale.
`overallPredictionTimeframe.endTime`	L'ora di fine del periodo di tempo della previsione. Questo valore viene impostato sei ore dopo l'ora di inizio.
`timeZone`	Il fuso orario della località richiesta.
`segments`	I segmenti di previsione a livello di minuto, indicati da `timeFrame`.
`segments.timeFrame`	Il periodo di tempo pertinente per il 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 quel segmento. I valori includono: `DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED` `NONE` `RAIN` `SNOW` `HAIL`
`segments.probability`	La probabilità prevista di precipitazioni durante quel segmento. I valori sono espressi in percentuali comprese tra 0 e 100.
`segments.qpf`	La previsione quantitativa delle precipitazioni.
`segments.qpf.quantity`	La quantità di precipitazioni prevista durante quel 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 quel segmento.
`segments.snowfallAmount.quantity`	La quantità di neve prevista (come equivalente di acqua liquida) durante quel 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: `PRECIPITATION_INTENSITY_UNSPECIFIED` `NO_INTENSITY` `LIGHT` `MODERATE` `HEAVY`
`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à nel 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 tempo complessivo della previsione:

  {
  "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"
    },
    ...
  ]
}