Rilevazioni

Export e API della stazione meteo.

Export dati

Scarica i dati in CSV o JSON.

Schema campi

Struttura dei dati restituiti dall'API.

Campo Tipo Unità Descrizione
timestampstringISO 8601Data e ora della rilevazione (UTC).
temperaturefloat°CTemperatura dell'aria
humidityfloat%Umidità relativa
wind_speedfloatm/sVelocità del vento
wind_directionfloat°Direzione del vento (0-360, 0=Nord)
rainfallfloatmmPrecipitazioni cumulate nel periodo
co_ppmfloatppmMonossido di carbonio
voc_ppbfloatppbComposti organici volatili
air_quality_indexfloatAQIIndice qualità dell'aria (0-500).
image_namestring | null—Nome file immagine webcam

Note

  • Tutti i timestamp sono in UTC. La conversione locale avviene lato client.
  • La stazione invia una rilevazione ogni 5 minuti.
  • air_quality_index può essere null se il sensore non è attivo.
  • L'API non richiede autenticazione per la lettura.

API Endpoints

Endpoint pubblici per leggere i dati.

GET /api/latest

Ultima rilevazione con stato connessione.

Parametri: nessuno
Risposta: oggetto JSON con tutti i campi dell'ultima misurazione, online (bool), seconds_since_last_ingest (int).
Esempio:
GET /api/latest
GET /api/measurements

Storico rilevazioni ordinate per timestamp.

Parametri query:
ParametroTipoDefaultDescrizione
daysint0Filtra per ultimi N giorni (1-90). 0 = nessun filtro.
limitint500Numero massimo di record (1-5000).
Esempio:
GET /api/measurements?days=7&limit=1000

Uso rapido API

  • Polling consigliato: ogni 60 secondi.
  • Per il giornaliero usa days=1, per settimanale days=7.
  • Imposta limit in base al tuo grafico per ridurre payload e latenza.
Richieste utili:
GET /api/measurements?days=1&limit=288
GET /api/measurements?days=7&limit=1000