Dades obertes
Tot el que es veu en aquest web es pot llegir en JSON o en CSV, per a qualsevol dels 4.293 llocs. No cal clau, no cal registre i no hi ha límit de peticions — el feed llegeix exactament els mateixos fitxers que la pàgina, així que servir-lo no ens costa cap consulta a cap API.
Punts d'accés
GET /api/lloc/{comarca}/{municipi}
Observació, predicció horària i diària, franges del dia, finestres de pluja amb la seva intensitat, qualitat de l'aire, avisos oficials i el resum en català — les mateixes frases que surten a la fitxa.
GET /api/lloc/{comarca}/{municipi}/{nucli}
Igual, per a un nucli o una entitat de població. És la raó de ser d'aquest projecte: la predicció de Lilla no és la de Montblanc.
GET /api/ranquings
Els extrems del dia: on ha fet la màxima i la mínima, quina estació ha tingut més amplitud tèrmica, on ha plogut més i les ratxes més fortes.
Paràmetres
| hours | Hores de sèrie horària comptades des de les 00:00 d'avui, no des d'ara: el feed torna el mateix que dibuixa la pàgina, dia sencer inclòs. Per defecte 48; el màxim és 168, que és l'horitzó del model.Si el que voleu són les pròximes N hores, el bloc forecast.now us diu l'hora en curs i el seu índex dins la sèrie, i així no heu de recalcular la zona horària de Madrid al client — que és exactament on ens vam equivocar nosaltres. |
| format=csv | La sèrie horària en CSV, amb el vent ja en km/h i la procedència a les línies de comentari. Pensat per obrir-lo en un full de càlcul./api/lloc/conca-de-barbera/montblanc?format=csv |
Què hi trobareu que no hi és en altres llocs
La procedència de cada número. Cada observació porta l'estació d'on surt, a quina distància és i quant desnivell hi ha. Trobareu temperature_station, que és la lectura crua, i temperature, que és la mateixa corregida pel desnivell amb el gradient estàndard de 6,5 °C/km. Amb les dues podeu decidir si us fieu de la correcció.
La intensitat de la pluja, no només l'acumulat. Cada finestra de pluja porta la seva hora punta i quants mil·límetres cauen en aquella hora, amb l'escala de l'AEMET. «Plou de 4 a 7» no distingeix quatre gotes d'una tempesta; peak_precipitation sí.
El desacord entre models. El camp spread és la desviació entre els models que entren al consens. Quan val null, és que en aquell punt només hi ha un model — i que no ho diguem seria amagar la incertesa.
Les frases. El bloc summary porta el resum en català generat amb plantilles deterministes. Qualsevol pot calcular una mitjana; això és el que costa de refer.
Condicions
Les dades són CC-BY 4.0: es poden fer servir per a qualsevol cosa, també comercial, però cal citar la font. Cada resposta porta un camp sources amb els crèdits exactes de cada bloc, perquè no són els mateixos: l'observació és del Meteocat, la predicció d'Open-Meteo, la qualitat de l'aire de CAMS i els avisos de l'AEMET.
Cada resposta porta també un camp version. Mentre valgui 1, els noms de camp no desapareixeran: si cal canviar-los, pujarà el número.
Els noms dels camps van en anglès i no en català. No és descuit: són els identificadors canònics que fa servir el projecte per dins, i coincideixen amb els d'Open-Meteo i de la XEMA. Traduir-los crearia un segon sistema de noms.
La predicció és orientativa i el feed no és un servei amb garanties. Per a decisions de seguretat, la font són el Meteocat i Protecció Civil. I si munteu res que depengui d'això, mireu l'estat de les dades: diu quan es va actualitzar cada font per última vegada, encara que la resposta sigui incòmoda.