Panoramica

L’API Meteo storico restituisce dati meteo giornalieri per una data e una località specifiche.

Endpoint

GET /historical/{lat},{lon},{timestamp}

Parametri

Parametro	Obbligatorio	Predefinito	Descrizione
`lat,lon,timestamp`	Sì	—	Latitudine, longitudine e timestamp come parametro del percorso
`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

Il timestamp accetta diversi formati:

Timestamp Unix: 1455537600
ISO 8601 con Z: 2016-02-15T12:00:00Z
ISO 8601 con offset: 2016-02-15T12:00:00+00:00
ISO 8601 senza fuso orario (assume UTC): 2016-02-15T12:00:00

Richiesta di esempio

GET /historical/47.37,8.55,2025-06-15T12:00:00Z?units=si

Risposta di esempio

{
  "latitude": 47.37,
  "longitude": 8.55,
  "timezone": "Europe/Zurich",
  "offset": 2,
  "daily": {
    "summary": "Partly cloudy throughout the day.",
    "icon": "01d",
    "data": [
      {
        "time": 1750003200,
        "summary": "Partly Cloudy",
        "icon": "01d",
        "is_day": true,
        "temperatureHigh": 24.5,
        "temperatureLow": 14.2,
        "temperatureAvg": 19.3,
        "windSpeed": 8.5,
        "windDirection": 210,
        "humidity": 0.58,
        "pressure": 1015.2,
        "visibility": 24.1,
        "cloudCover": 0.35,
        "precipitation": 0,
        "sunriseTime": 1749956400,
        "sunsetTime": 1750013400,
        "moonPhase": 0.72
      }
    ]
  }
}

Campi dei dati giornalieri

Campo	Tipo	Descrizione
`time`	integer	Timestamp Unix (inizio del giorno)
`summary`	string	Riassunto meteo 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
`temperatureHigh`	float	Temperatura massima diurna
`temperatureLow`	float	Temperatura minima notturna
`temperatureAvg`	float	Temperatura media del giorno
`windSpeed`	float	Velocità media del vento
`windDirection`	integer	Direzione prevalente del vento (0–360°)
`humidity`	float	Umidità relativa media (0–1)
`pressure`	float	Pressione al livello del mare (hPa)
`visibility`	float	Distanza di visibilità
`cloudCover`	float	Copertura nuvolosa (0–1)
`precipitation`	float	Precipitazioni totali
`precipitationType`	string	Tipo di precipitazione (se applicabile)
`sunriseTime`	integer	Timestamp Unix dell’alba
`sunsetTime`	integer	Timestamp Unix del tramonto
`moonPhase`	float	Fase lunare (0 = luna nuova, 0.5 = luna piena)

Errori

Status	Descrizione
`400`	Formato località non valido, coordinate fuori intervallo o timestamp futuro
`403`	Chiave API non valida
`429`	Limite di richieste superato
`503`	Dati storici non caricati