Panoramica dell'API Weather

L'API Weather ti consente di richiedere dati meteo iperlocali in tempo reale per località di tutto il mondo per alimentare dashboard meteo in tempo reale, app di aggiornamento meteo, overlay meteo dei percorsi e activity tracker o salute basati sul meteo. Le informazioni meteo includono la temperatura attuale, le precipitazioni, l'umidità relativa, la velocità del vento, l'indice UV e altro ancora.

Per una località a una determinata latitudine e longitudine, l'API fornisce endpoint (https://weather.googleapis.com/v1/...) per i dati nella tabella seguente.

Riepilogo degli endpoint REST

Endpoint API URL Descrizione Parametri documentati
Condizioni attuali https://weather.googleapis.com/v1/currentConditions:lookup Condizioni meteo in tempo reale location.latitude, location.longitude
Previsione oraria https://weather.googleapis.com/v1/forecast/hours:lookup Fino a 240 ore di condizioni previste location.latitude, location.longitude
Previsioni giornaliere https://weather.googleapis.com/v1/forecast/days:lookup Fino a 10 giorni di condizioni previste location.latitude, location.longitude
Cronologia oraria https://weather.googleapis.com/v1/history/hours:lookup Fino a 24 ore di condizioni passate memorizzate nella cache location.latitude, location.longitude
Allerte condizioni meteo estreme https://weather.googleapis.com/v1/publicAlerts:lookup Allerte condizioni meteo estreme key, location.latitude, location.longitude

Casi d'uso comuni

Funzionalità dell'API Weather

I dati dell'API Weather includono:

  • Condizioni meteo e icone: una descrizione e l'icona corrispondente che indicano le condizioni meteo attuali (ad esempio, "Nuvoloso" o "Nevicate sparse") in weatherCondition.
  • Temperatura: temperatura attuale (temperature), temperature minime e massime (minTemperature e maxTemperature nelle previsioni giornaliere o all'interno di currentConditionsHistory) e temperatura apparente ("percepita") (feelsLikeTemperature).
  • Precipitazioni: precipitazioni totali e tipo di precipitazioni (neve, pioggia, ghiaccio, misto).
  • Vento: temperatura percepita (windChill), direzione del vento (wind.direction), velocità del vento (wind.speed) e raffiche (wind.gust).
  • Spessore del ghiaccio: spessore del ghiaccio.
  • Umidità: punto di rugiada (dewPoint), indice di calore (heatIndex), temperatura di bulbo umido (wetBulbTemperature) e umidità relativa (relativeHumidity).
  • Indice UV: indice ultravioletto (UV) (uvIndex).
  • Probabilità di temporali: la probabilità percentuale che si verifichi un temporale.
  • Visibilità: la distanza alla quale un oggetto è chiaramente visibile.
  • Pressione atmosferica: la pressione atmosferica media sul livello del mare.
  • Eventi solari e lunari: orari di alba, tramonto, sorgere e tramontare della luna.
  • Copertura nuvolosa: la percentuale di cielo coperta da nuvole.

Come utilizzare l'API Weather

1 Configurazione Inizia con Configura il progetto Google Cloud e completa le istruzioni riportate di seguito.
2 Ottieni le condizioni attuali Vedi Recupera le condizioni attuali.
3 Ricevi previsioni orarie Consulta Visualizza le previsioni orarie.
4 Ricevi le previsioni giornaliere Consulta Ricevi le previsioni giornaliere.
5 Visualizza la cronologia oraria Consulta Recupera la cronologia oraria.
6 Ricevi allerte meteo Consulta Ricevi avvisi meteo.

Per l'indice di qualità dell'aria (IQA) e gli inquinanti da particolato (PM2.5, PM10), utilizza l'API Air Quality (https://airquality.googleapis.com/v1/currentConditions:lookup). L'API Weather non restituisce questi valori.

Altre API ambientali correlate includono:

  • Conteggi dei pollini: API Pollen (https://pollen.googleapis.com/v1/forecast:lookup)
  • Irradiazione solare e potenziale dei tetti: API Solar (https://solar.googleapis.com/v1/buildingInsights:findClosest)

Passaggi successivi