
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 beolvassa a másnapi piac eredményeit az aktuális szállítási napra: 96 árat, a nap minden 15 perces időszakára egyet (az időszakok kezdete 00:00–23:45; 1. időszak = 00:00–00:15, 96. időszak = 23:45–24:00). 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 kurz változó (amelyet a Devizaárfolyam eszköz jelenít meg és tesz szerkeszthetővé) 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 15 perces időszak 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 időszak árának rangja a nap mind a 96 időszaka között (1 = legolcsóbb, 96 = 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 időszak 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 árainak 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 15 perces időszakának száma (1–96)
- Legolcsóbb hátralévő időszak — a legolcsóbb 15 perces időszak az aktuális időponttól kezdve
- Időszakok száma — az API-válaszban szereplő 15 perces áridőszakok teljes száma (normál napon 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 az aktuális szállítási nap egy 15 perces időszakának nyers spot árát mutatja EUR-ban. Hasznosak diagnosztikához vagy egyéni automatizálások készítéséhez, amelyek a nap meghatározott időszakait vizsgálják.
Ö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 időszakokban — hasonlítsd össze az aktuális időszak rangját egy küszöbértékkel (pl. rang <= 8), és kapcsold be a vízmelegítőt csak a nap 8 legolcsóbb 15 perces időszakában (2 óra)
- 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.