Previsioni

Panoramica

L’API Previsioni restituisce le condizioni attuali, le precipitazioni al minuto, le previsioni orarie e giornaliere e gli avvisi meteo per una data coordinata.

Endpoint

GET /forecast/{lat},{lon}

Parametri

Parametro	Obbligatorio	Predefinito	Descrizione
lat,lon	Sì	—	Latitudine e longitudine come parametro del percorso (es. 47.37,8.55)
units	No	us	Sistema di unità: us (imperiale), si (metrico), ca (metrico con vento in km/h), uk (metrico con vento in mph), auto (basato sul paese)
lang	No	en	Codice lingua per i riassunti testuali
extend	No	—	Imposta su hourly per estendere le previsioni orarie oltre le 48 ore
exclude	No	—	Blocchi da escludere separati da virgola: currently, minutely, hourly, daily, alerts

Richiesta di esempio

GET /forecast/47.37,8.55?units=si

Risposta di esempio

{
  "latitude": 47.37,
  "longitude": 8.55,
  "timezone": "Europe/Zurich",
  "offset": 1,
  "elevation": 408,
  "currently": {
    "time": 1709132400,
    "summary": "Partly Cloudy",
    "icon": "01d",
    "is_day": true,
    "temperature": 8.2,
    "apparentTemperature": 5.1,
    "humidity": 0.65,
    "pressure": 1018.5,
    "windSpeed": 12.3,
    "windDirection": 230,
    "cloudCover": 0.45,
    "visibility": 16.1
  },
  "hourly": {
    "summary": "Partly cloudy throughout the day.",
    "icon": "01d",
    "data": [
      {
        "time": 1709132400,
        "summary": "Partly Cloudy",
        "icon": "01d",
        "is_day": true,
        "temperature": 8.2,
        "apparentTemperature": 5.1,
        "humidity": 0.65,
        "pressure": 1018.5,
        "windSpeed": 12.3,
        "windDirection": 230,
        "cloudCover": 0.45,
        "precipitation": 0,
        "precipitationType": "none"
      }
    ]
  },
  "daily": {
    "summary": "Partly cloudy for the week.",
    "icon": "01d",
    "data": [
      {
        "time": 1709082000,
        "summary": "Partly cloudy throughout the day.",
        "icon": "01d",
        "is_day": true,
        "temperatureHigh": 11.5,
        "temperatureLow": 3.2,
        "humidity": 0.62,
        "pressure": 1018.5,
        "windSpeed": 15.1,
        "windDirection": 240,
        "cloudCover": 0.4,
        "precipitation": 0,
        "sunriseTime": 1709101200,
        "sunsetTime": 1709139600,
        "moonPhase": 0.62
      }
    ]
  },
  "alerts": []
}

Blocchi della risposta

currently

Condizioni meteo attuali nella località richiesta.

Campo	Tipo	Descrizione
time	integer	Timestamp Unix
summary	string	Riassunto leggibile
icon	string	Codice condizione meteo con suffisso giorno/notte (es. "01d", "07n"). Vedi Icone meteo.
is_day	boolean	Se il punto dati cade nelle ore diurne
temperature	float	Temperatura
apparentTemperature	float	Temperatura percepita
humidity	float	Umidità relativa (0–1)
pressure	float	Pressione al livello del mare (hPa)
windSpeed	float	Velocità del vento
windDirection	integer	Direzione del vento (0–360°)
cloudCover	float	Copertura nuvolosa (0–1)
visibility	float	Distanza di visibilità

hourly

Previsioni orarie per le prossime 48 ore (o estese con extend=hourly). Ogni elemento in data contiene gli stessi campi di currently.

daily

Previsioni giornaliere per i prossimi 7 giorni. Ogni elemento in data include:

Campo	Tipo	Descrizione
time	integer	Timestamp Unix (inizio del giorno)
summary	string	Riassunto giornaliero leggibile
temperatureHigh	float	Temperatura massima diurna
temperatureLow	float	Temperatura minima notturna
sunriseTime	integer	Timestamp Unix dell’alba
sunsetTime	integer	Timestamp Unix del tramonto
moonPhase	float	Fase lunare (0 = luna nuova, 0.5 = luna piena)
precipitation	float	Precipitazioni giornaliere totali

alerts

Array degli avvisi meteo attivi per l’area. Ogni avviso include title, description, time, expires e severity.

Unità

Misura	us	si	ca	uk
Temperatura	°F	°C	°C	°C
Velocità del vento	mph	m/s	km/h	mph
Precipitazioni	in/hr	mm/hr	mm/hr	mm/hr
Visibilità	mi	km	km	mi
Altitudine	ft	m	m	m

Errori

Status	Descrizione
400	Coordinate o parametri non validi
403	Chiave API non valida
429	Limite di richieste superato
503	Dati delle previsioni non caricati