Az OTE-CR (Operátor trhu s elektřinou) a cseh villamos energia- és gázpiaci üzemeltető. A TapHome sablon a nyilvános OTE-CR API-ról tölti le a másnapi piaci spot árakat, és eszközökként teszi elérhetővé — aktuális ár, napi statisztikák, rangsor és időablak-változatok. Az árak EUR/MWh-ban kerülnek közzétételre, és a sablon beépített devizaátváltási változót tartalmaz az értékek CZK-ban történő megjelenítéséhez.
A sablon óránként lekérdezi az OTE-CR API-t, és legfeljebb 96 óránkénti áridőszakot tölt le (4 nap adat). Nincs szükség hitelesítésre — az API végpont nyilvános.
Konfiguráció
A sablon importálása során a TapHome csatlakozik a www.ote-cr.cz címhez HTTPS-en (443-as port). Nincs szükség IP-címre vagy hitelesítő adatokra — a végpont rögzített.
Két opcionális importparaméter vezérli az időablak-eszközöket:
- From — kezdő óra (0–23, alapértelmezett: 9) az időablak szűrőhöz
- To — záró óra (0–23, alapértelmezett: 17) az időablak szűrőhöz
Az alapértelmezett értékek (9–17) a szokásos munkaidőt fedik le. Állítsd be a kívánt elemzési ablaknak megfelelően.
Importálás után a Devizaárfolyam (kurz) változó alapértelmezetten 1 — ez azt jelenti, hogy minden áreszköz a nyers EUR/MWh értékeket jeleníti meg. Állítsd be az aktuális EUR/CZK árfolyamra (pl. 25,2), hogy minden áreszköz CZK-ban jelenítse meg az értékeket. Az árfolyamot beállíthatod manuálisan az eszköz részleteiben, vagy összekapcsolhatod a ČNB árfolyam sablonnal az automatikus napi frissítésekhez (lásd alább).
Eszközképességek
Aktuális ár
Az Aktuális ár eszköz az aktuális óra spot árát olvassa. A sablon a rendszeróra alapján határozza meg az aktív időszakot, és az EUR értéket megszorozza az árfolyammal, hogy a CZK-ban adja meg az árat.
Árrangsor
- Aktuális időszak rangja — az aktuális óra árának rangja a nap összes időszaka között (1 = legolcsóbb, 24 = legdrágább)
- Aktuális időszak rangja az időablakban — ugyanaz a rangsor, de a felhasználó által meghatározott időablakra (From–To) korlátozva. NaN-t ad vissza, ha az aktuális óra az ablakon kívül esik.
Napi árstatisztikák
- A nap legmagasabb ára — a maximális spot ár az összes időszakban, CZK-ra átváltva
- A nap legalacsonyabb ára — a minimális spot ár az összes időszakban, CZK-ra átváltva
- A nap átlagos ára — az összes időszak számtani átlaga, CZK-ra átváltva
Időablak árstatisztikák
Minden napi statisztikának van egy időablak-változata, amely az időszakokat a From–To tartományra szűri:
- Legmagasabb ár az időablakban
- Legalacsonyabb ár az időablakban
- Átlagos ár az időablakban
Minden időablak-eszköz NaN-t ad vissza, ha From >= To.
Időszak-navigáció
- A nap legolcsóbb időszaka — a nap legolcsóbb órájának 1-bázisú időszakszáma
- Legolcsóbb hátralévő időszak — a legolcsóbb óra az aktuális időponttól kezdve
- Időszakok száma — az elérhető áridőszakok teljes száma (jellemzően 96)
- Időszakok száma az időablakban — a From–To tartományon belüli időszakok száma
Devizaárfolyam
A Devizaárfolyam eszköz az egyetlen olvasható és írható eszköz a sablonban. Az EUR-CZK átváltási árfolyamot tárolja, amelyet az összes áreszköz használ. Állítsd be manuálisan, vagy kapcsold össze a ČNB árfolyam sablonnal az automatikus napi frissítésekhez.
Ha az árfolyam 1-re van állítva, az összes áreszköz a nyers EUR értékeket adja ki.
Szervizattribútumok
A sablon 96 szervizattribútumot tesz elérhetővé (1. időszak–96. időszak), amelyek mindegyike a megfelelő óraslot nyers spot árát mutatja EUR-ban. Ezek körülbelül 4 nap másnapi piaci adatot fednek le, és hasznosak diagnosztikához vagy egyéni automatizálások készítéséhez, amelyek meghatározott jövőbeli időszakokat vizsgálnak.
Összekapcsolás a ČNB árfolyammal
Az EUR-CZK átváltás automatizálásához:
- Importáld a ČNB árfolyam sablont (Kurzy ČNB) a TapHome-ba
- Az OTE-CR sablonban hozz létre egy képletet, amely a ČNB eszközből olvassa az EUR/CZK árfolyamot, és beírja a Devizaárfolyam eszközbe
- A ČNB sablon naponta frissíti az árfolyamot, így az összes OTE-CR ár automatikusan tükrözi az aktuális árfolyamot
Automatizálási példák
A spot árak a leghasznosabbak a TapHome smart rules-szal kombinálva:
- Vízmelegítés a legolcsóbb órákban — hasonlítsd össze az aktuális időszak rangját egy küszöbértékkel (pl. rang <= 4), és kapcsold be a vízmelegítőt csak a nap 4 legolcsóbb órájában
- Akkumulátorok töltése csúcsidőn kívül — használd az Aktuális ár eszközt az akkumulátortöltés indításához, amikor az ár egy beállítható limit alá csökken
- Készülékterhelés eltolása — használd a Legolcsóbb hátralévő időszak eszközt mosógépek, mosogatógépek vagy EV-töltés ütemezéséhez a következő legolcsóbb slotra
- Időablak-optimalizálás — korlátozd az automatizálást meghatározott órákra (pl. 6:00–22:00) az időablak-eszközök segítségével, hogy az éjszakai időszakok ki legyenek zárva a rangsorból
Hibaelhárítás
Minden ár nullát vagy NaN-t mutat
- Ellenőrizd, hogy a TapHome CCU rendelkezik-e internet-hozzáféréssel (a sablon HTTPS-en csatlakozik a
www.ote-cr.czcímhez) - Ellenőrizd az Időszakok száma eszközt — ha 0-t mutat, az API válasz üres, vagy az elemzés sikertelen volt
- Győződj meg róla, hogy a Devizaárfolyam eszköz nullától eltérő értékre van állítva — a 0-s árfolyam az összes árat nullára szorozza
Az időablak-eszközök NaN-t adnak vissza
- Ellenőrizd, hogy a From és To importparaméterek megfelelően vannak-e beállítva (From-nak kisebbnek kell lennie, mint To)
- Ha az aktuális óra a From–To tartományon kívül esik, az ablak-rangsor eszköz tervezés szerint NaN-t ad vissza
Az árak elavultnak tűnnek
A sablon óránként lekérdezi az OTE-CR API-t (3600 másodperc). A másnapi piaci árakat az OTE az előző napon teszi közzé, jellemzően 12:45 CET körül. Ha az új nap árai még nem láthatók, várd meg a közzétételi időpontot.