API pública

Endpoints

Parámetros

Campos de cada estación

Histórico

Con history=daily, cada estación incluye history.items con date, mean, min, max, rain, wind, gust y source. Si la fuente es station, el resumen es el oficial que publica la estación. Si es meteovallsdaneu, se ha calculado con las lecturas guardadas por nuestro recopilador, como mínimo 6 por día.

Con history=readings, history.items contiene cada lectura guardada con los mismos campos que la lectura actual. El recopilador guarda una lectura nueva de cada estación cada 5 minutos, cuando la estación ha publicado una.

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

Cobertura de datos

Desde cuándo tenemos datos de cada estación. El archivo propio crece con cada lectura y no se puede reconstruir hacia atrás.

Calidad y uso

null significa que el valor no está disponible; no equivale a cero. live indica una lectura de temperatura de menos de 30 minutos; stale, una lectura antigua; undated, hora no verificada; unavailable, ausencia de temperatura. Un estado live no garantiza que todos los sensores tengan lectura.

Caché de 60 segundos y ETag con respuestas 304. Consulta como máximo una vez por minuto y reutiliza el resultado en tu aplicación. Métodos GET, HEAD y OPTIONS.

Ejemplo de integración

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 «Fuente: Meteo Valls d’Àneu» cuando muestres los datos. Las observaciones son automáticas y pueden ser incompletas; comprueba siempre observedAt y status. La propiedad generatedAt indica la generación de la respuesta, no la hora del sensor.