API pública

Endpoints

Paràmetres

Camps de cada estació

Històric

Amb history=daily, cada estació inclou history.items amb date, mean, min, max, rain, wind, gust i source. Si la font és station, el resum és l’oficial que publica l’estació. Si és meteovallsdaneu, s’ha calculat amb les lectures desades pel nostre recopilador, com a mínim 6 per dia.

Amb history=readings, history.items conté cada lectura desada amb els mateixos camps que la lectura actual. El recopilador desa una lectura nova de cada estació cada 5 minuts, quan l’estació n’ha publicat una.

GET https://meteovallsdaneu.com/api.php?station=gento&history=daily&days=7

Cobertura de dades

Des de quan tenim dades de cada estació. L’arxiu propi creix amb cada lectura i no es pot reconstruir cap enrere.

Qualitat i ús

null vol dir que el valor no està disponible; no equival a zero. live indica una lectura de temperatura de menys de 30 minuts; stale, una lectura antiga; undated, hora no verificada; unavailable, absència de temperatura. Un estat live no garanteix que tots els sensors tinguin lectura.

Memòria cau de 60 segons i ETag amb respostes 304. Consulta com a màxim un cop per minut i reutilitza el resultat a la teva aplicació. Mètodes GET, HEAD i OPTIONS.

Exemple d’integració

const response = await fetch(
  'https://meteovallsdaneu.com/api.php?station=esterri'
);
const { stations } = await response.json();
const station = stations[0];
if (station.status === 'live' && station.temp !== null) {
  console.log(station.temp, station.observedAt);
}

Indica «Font: Meteo Valls d’Àneu» quan mostris les dades. Les observacions són automàtiques i poden ser incompletes; comprova sempre observedAt i status. La propietat generatedAt indica la generació de la resposta, no l’hora del sensor.