EMSN

Type minstens twee letters. Resultaten verschijnen vanzelf, geen Enter nodig.

EN
§ OD · Open data Alles wat de Pi's verzamelen

Pak een endpoint.
Doe er iets moois mee.

Alle live cijfers op deze site komen uit een handvol JSON-endpoints op api.ronnyhullegie.nl. Je mag ze gewoon ophalen. Onderzoek, eigen visualisatie, schoolproject. Bel even mee, deel wat je maakt.

§ OD · 02 Snel proberen
In de terminal
curl https://api.ronnyhullegie.nl/api/weer/current
In de browser

Plak de URL in je adresbalk. JSON wordt direct getoond. Firefox en Chrome formatteren het netjes. Voor een eigen project: fetch() in JavaScript, requests.get() in Python. De API staat open voor elk domein (CORS *) en beantwoordt ook HEAD, dus een pagina op je eigen site kan er rechtstreeks uit lezen.

Machineleesbaar

De volledige, altijd actuele beschrijving staat in openapi.json en als bladerbare pagina op api.ronnyhullegie.nl/docs. De lijst hieronder is een leesbare samenvatting daarvan.

§ OD · 03 Alle endpoints

Basis-URL is altijd https://api.ronnyhullegie.nl/api. Elke endpoint is GET, antwoordt met JSON, en geeft een generated_at-veld zodat je weet hoe vers de data is.

Weer

/weer/current
Laatste meting van het Davis-station
cache · 60 sec
/weer/dag
24 uur in bins van een uur: temp, wind, vocht, druk, regen
cache · 60 sec
/weer/week
7 dagen regen + windroos in 8 sectoren
cache · 60 sec
/weer/maand
Lopende maand: per dag stats + aggregaten
cache · 300 sec
/weer/vorig-jaar
Vandaag, precies een jaar geleden
cache · 1 uur
/weer/status
First/last measurement, uptime, sensoren-overzicht
cache · 60 sec

Akoestiek

/akoestiek/zolder
Bladerdak: stats, laatste, top vandaag, vocalisaties, uur-curve
cache · 60 sec
/akoestiek/berging
Struikgewas: zelfde structuur als Bladerdak
cache · 60 sec
/weer-detecties
Correlaties tussen weertypen en vogelactiviteit
cache · 600 sec
/soorten
Soortenindex: alle waargenomen vogel- en vleermuissoorten met totalen
cache · 30 min
/soort/{soort_type}/{slug}
Soortportret: reeks, seizoen, uur-curve, vocalisaties. soort_type is vogel of vleermuis
cache · 30 min
/dag/{datum}
Tijdmachine: alles van één dag (YYYY-MM-DD)
cache · 2 min (vandaag) · 1 uur (eerder)
/detectie/lookup
Zoek een detectie op id of bestandsnaam (querystring)
cache · 5 min
/detectie/{soort}/{det_id}
Permalink van één detectie met audio- en spectrogramverwijzing
cache · 5 min
/jaarwiel/{jaar}
Jaarwiel: activiteit per week en per uur voor een jaar
cache · 1 uur
/jaarverslag/jaren
Welke jaren een jaarverslag hebben
cache · 1 uur
/jaarverslag/{jaar}
Jaarverslag: ontdubbelde totalen en hoogtepunten van een jaar
cache · 1 uur

Vleermuizen

/vleermuizen
Stats voor nacht-window, soorten-overzicht, 24u-grafiek
cache · 120 sec

Hemel

/atmosbird
Hemelcamera nu + time-lapse + vondsten (ISS, meteoren, maan)
cache · 120 sec

Vogeltrek

/vogeltrek
FlySafe-radar agregaten: uur-reeks, dag-reeks, categorie-verdeling
cache · 300 sec

Nestkasten

/nestkast/list
Drie nestkasten met laatste-event en seizoenstatus
cache · 120 sec
/nestkast/{id}/seizoen
Tijdlijn + counters per kast. Id is voor/midden/achter
cache · 120 sec
/nestkast/{id}/media
Recente screenshots + per-dag-heatmap per kast
cache · 120 sec

Techniek

/techniek
Totalen per pipeline en hardware-overzicht
cache · 1 uur
/techniek/machines
Zes knooppunten: online, CPU, temperatuur, geheugen, schijf, draaitijd
cache · 30 sec
§ OD · 04 Media en fragmenten

Voor audio, spectrogrammen en hemelfoto's draait een aparte media-host. Daar staan ook twee JSON-indexen klaar voor wie alle fragmenten in één lijst wil.

sonar/index.json
Vleermuisfragmenten met spectrogrammen en time-expanded MP3s
https://media.ronnyhullegie.nl/sonar/index.json
§ OD · 05 Spelregels
Licentie
CC BY-NC 4.0 — gebruiken mag, ook aanpassen, mits je EMSN noemt en het niet commercieel inzet.
Wees zuinig
De NAS heeft één Davis, drie Pi's en een paar microfoons. Hammer er niet op. Cache-tijden volgen, geen polls vaker dan eens per minuut.
Iets gebouwd?
Stuur een mailtje via de Over-pagina — ik vind het leuk om te zien wat anderen ermee doen, en kan je werk eventueel terugkoppelen op de site.