ELEKTER / PUBLIC API V1
Andmed, millega edasi ehitada.
Väike avalik lugemisliides neile samadele andmetele, mida näed Elekteris. Ilma konto, võtme või makseta. Mitteäriline uurimisprojekt.
Alusta ühest päringust
curl --fail --silent --show-error 'https://elekter.pages.dev/api/public/v1/estonia'Kuus lihtsat alguspunkti
| GET | Vastus | Päringute vahe |
|---|---|---|
/api/public/v1/estonia/grid-flowelekter-grid-flow/1 | Tunnipõhine kvalitatiivne võrgumudel, allikasegu ja päritolu. hour=UTC tunni algus täpseks taasesituseks; view=overview valib kuni 24 h vanuse ühise andmehetke (vähemalt 80% allikakaetus). Üle 6 h vana hetke valiku alus on last_complete_snapshot; vanema ühise hetke korral tagastatakse uusim jaotusvõrk. | 15 min |
/api/public/v1/estonia/plants?lat=58.38&lon=26.73elekter-estonia-plants/2 | Piirkonna modelleeritud elektriallikad. hour=UTC tunni algus küsib täpselt kaardiga sama tunni allikaid; puuduva tunni korral teist hetke ei asendata. | 15 min |
/api/public/v1/estoniaelekter-public-estonia/1 | Avaldatud 15 minuti hinnad, tänane ja homne päev, allikate seisund. | 5 min |
/api/public/v1/estonia/mixelekter-estonia-mix/1 | Eestis mõõdetud tootmisjaotus ja sellest modelleeritud CO₂ intensiivsus. Üle 3 h vana mõõtmine on delayed; üle 24 h vana mõõtmist ei väljastata. | 5 min |
/api/public/v1/estonia/solar-point?lat=58.38&lon=26.73elekter-solar-point/1 | Ühe koha kiirgus- ja temperatuuriprognoos Puhubi kaudu. Näide: Tartu. | 15 min |
/api/public/v1/estonia/skillelekter-skill-record/1 | Prognoosikatsete avalik kontroll: valim, alusjoon, staatus ja tulemused. | 1 h |
Need on soovituslikud minimaalsed päringuvahed, mitte allika uuendamise lubadus. Kasuta vahemälu ja kontrolli vastuse allika aega.
Numbrid vajavad konteksti
- Hind on EUR/MWh või senti/kWh: 100 €/MWh = 10 senti/kWh. See on börsihind enne makse, võrgutasusid ja marginaale.
- Ajatemplid on UTC. Eesti turupäev järgib Europe/Tallinn ajavööndit: kellakeeramise päeval ei pruugi olla 96 veerandtundi.
- Hinna null tähendab puuduvat väärtust; arv 0 tähendab päris nullhinda. Homne not_published ei ole hinnaprognoos.
- solar-point väljastab W/m² kiirguse, mitte paneeli võimsuse. end_utc märgib eelneva tunni keskmise lõppu. Puhub vahendab lähima ilmaennustusruudu prognoosi; asukoht ümardatakse päringus kahe komakohani.
- CO₂ kirjeldab Eestis toodetud elektri modelleeritud elutsükli intensiivsust. See ei ole impordiga kaalutud tarbimisnäit ega välditud heide.
- Täpsusaruandes kontrolli live_accuracy_published ja iga kirje staatust. Väikese valimi esialgset tulemust ei tohi esitada tõestatud täpsusena.
Algallikad
- Elering — avaldatud turuhinnad.
- ENTSO-E Transparency Platform — mõõdetud tootmine ja piiriülesed vood; kasutustingimused.
- MET Norway / Puhub — ilmaprognoos ja selle töötlus.
- Maa- ja Ruumiamet — aadressiotsing ja Eesti ruumiandmed; andmete kasutamine.
- PyPSA-Eur — Euroopa võrgu- ja elektrijaamamudeli alusandmed (2024-08 lähteversioon). Alusallikatel võivad olla erinevad litsentsid.
Väike brauserinäide
const response = await fetch('https://elekter.pages.dev/api/public/v1/estonia');
if (!response.ok) throw new Error('Electricity data unavailable');
const data = await response.json();
if (data.schema_version !== 'elekter-public-estonia/1') {
throw new Error('Unsupported schema');
}
const price = data.components.price;
console.log('Source status:', price.status, price.retrieved_at);
for (const day of price.days ?? []) {
for (const point of day.points) {
if (point.eur_per_mwh !== null) {
console.log(point.start_utc, point.eur_per_mwh, 'EUR/MWh');
}
}
}GET ja OPTIONS lubavad brauseripäringuid teistest domeenidest. Järgi Cache-Control päist. 400 viitab vigasele asukohale, 405 lubamatule meetodile ja 503 kättesaamatule või kontrolli mitteläbinud allikale. Piira korduskatseid ja lisa kasvav ooteaeg.
Kasutamine ja allikad
Liides on avatud isiklikuks katsetamiseks ja uurimiseks, ilma teenustaseme garantiita. Avalik ligipääs ei anna piiramatut õigust alusandmeid edasi müüa või levitada. Kommertskasutuse kavandamisel tuleb eraldi kontrollida algallikate tingimusi; ärilist API-teenust me praegu ei paku.
Viita Elekterile ja säilita vastuse allikateave: Eleringi elektrituruandmed, ENTSO-E tootmisandmed Wattography kaudu ning Puhubi ilmatöötlus MET Norway andmetega. Väldi hulgiarhiivi kraapimist ja ära kasuta liidest kriitiliste juhtimissüsteemide alusena.