Solar.web Query API

Az aktuális oldal sajnos nem elérhető a kiválasztott nyelven.

Szeretne nyelvet váltani és felkeresni a kezdőoldalt, vagy szeretne az aktuális oldalon maradni?

Nyelvváltás
Solar.web Query API

Számlázás

Költségek csak akkor merülnek fel, ha adatot kérnek le. Felhasználásonkénti fizetős modellt kínálunk, amely maximális átláthatóságot biztosít az ügyfél számára. Csak a kért adat mennyiségéért kell fizetni. Ha nincsenek adatpontok, az nem jelent költséget. Az adatpontok mennyisége megtekinthető a Solar.web oldalon, ahol az aktuális és az elmúlt hónapok összes mennyisége szerepel. Az aktuális hónapra vonatkozó összeg naponta frissül.

Ezenkívül ez a modell nagyfokú rugalmasságot biztosít az API használata során. Például az API-lekérdezéseket ciklikusan (pl. csak a hét bizonyos napjain, bizonyos napszakokban stb.) végezheti el, és a lekérdezéstől függően lehetőség van időtartományok és szűrők használatára is. Így elkerülheti a nem kívánt értékek lekérdezését, és ezáltal minimalizálhatja az adatforgalmat, valamint a szerver infrastruktúrájának terhelését.

Ha Ön nem használja aktívan API-szolgáltatásainkat (0 adatpont), akkor az adott időszakban nem merülnek fel költségek. Ezért Ön nem kap számlát. 
Vannak napelemes rendszeradatokra és inverteradatokra vonatkozó kérések. Az adatpontokat minden lekérdezés esetében összegezzük. A napelemes rendszeradatokra vonatkozó lekérdezések esetében a rendszerben lévő inverterek száma nem lényeges az adatpontok számának meghatározása szempontjából. Másrészt az inverteradatok lekérdezésekor a napelemes rendszer adatpontjait nem veszik figyelembe.

A napelemes rendszerekre vonatkozó bizonyos alapvető információk adatpontjai, mint például a rendszerek és az alkatrészek száma, nem számítanak. Az ilyen lekérdezések gyakorisága irreleváns.

A napelemes rendszerre vonatkozó részletes információk, a valós idejű adatok (teljesítményáramlások) és az aktuális időjárási adatok válaszonként egy adatpontnak számítanak. A lekérdezések gyakorisága az alkalmazás céljától függően szabadon megválasztható (pl. 30 másodpercenként a valós idejű adatok esetében, óránként egyszer az aktuális időjárási adatok esetében stb.)

A múltbeli és összesített energiaadatokat (pl. termelés és fogyasztás, valamint előrejelzési adatok) és a szolgáltatási üzeneteket értékenként és időbeni adatpontokként kell számolni. Ha a teljes fogyasztást és az önfogyasztást egy 10 órás időszakra vonatkozóan kérdezzük le (figyelembe véve az inverteren beállított 5 perces alapértelmezett naplózási időintervallumot), az adatpontok száma a következőképpen számítható ki:

60 perc / 5 perces naplóintervallum = 12 adatpont óránként.

Ha ezt a 12 adatpontot megszorozzuk a 10 órás lekérdezési időszakkal, akkor 120 adatpontot kapunk lekérdezett értékenként. Mivel példánkban két értéket kérdezünk le, az adatpontok végső összege 240 lesz.

Az alábbiakban néhány számítási mintát mutatunk be különböző alkalmazásokhoz.

 

Adatlekérdezés egy intelligens mérővel rendelkező napelemes rendszerhez

Az energiaáramlási adatok lekérdezése a napelemes rendszer szintjén történik (nem az inverter szintjén). Az adatokat napi 24 órán keresztül 60 másodpercenként kéri le.

A havi adatpontok mennyisége a következőképpen kerül kiszámításra:

60 lekérdezés/óra x 24 óra x 30 nap = 43 200 adatpont havonta.

 

Adatlekérdezés egy okosmérővel rendelkező napelemes rendszerhez

A három API-csatornára vonatkozó összesített energiaadatok lekérdezése a hálózati betáplálás, a hálózati teljesítmény és az önfogyasztás tekintetében. Az adatokat óránként, napi 24 órában kérik le napi, havi, éves és összesített értékekre vonatkozóan.

A havi adatpontok mennyiségét a következőképpen számítják ki:

1 lekérdezés/óra x 4 időintervallum x 3 csatorna x 24 óra x 30 nap = 8 640 adatpont havonta

 

Adatlekérdezés egy intelligens mérővel rendelkező napelemes rendszerhez

A múltbeli energiaadatok lekérdezése a három API-csatornára („hálózati betáplálás”, „hálózati teljesítmény” és „önfogyasztás”) vonatkozóan történik. Az adatokat 5 percenként (ez megfelel a Fronius inverterek alapbeállításának), napi 24 órában kéri le.

A havi adatpontok mennyisége a következőképpen kerül kiszámításra:

12 lekérdezés/óra x 3 csatorna x 24 óra x 30 nap = 25 920 adatpont havonta.

 

Adatlekérdezés egy 10 inverterrel rendelkező napelemes rendszerhez

Egy API-csatornára (termelt energia) vonatkozóan előzmény adatokat kérdezünk le. 

A lekérdezés 5 perces időközönként adja meg az adatokat napi 14 órára (az inverter szokásos üzemideje). 

A havi adatpontok mennyisége a következőképpen kerül kiszámításra:

12 lekérdezés/óra x 10 inverter x 1 csatorna x 14 óra x 30 nap = 50 400 adatpont havonta.

 

Adatlekérdezés napelemes rendszerhez, okosmérővel és akkumulátoros tárolóval egy távfelügyeleti rendszer megoldáshoz.

Mivel a gyakorlatban több különböző adatkérés kombinációja gyakori, ebben az alkalmazási példában a végfelhasználók számára egy napelemes vizualizációs alkalmazás biztosításához szükséges adatlekérdezés kerül bemutatásra.

Az energiaáramlási adatok lekérdezése a napelemes rendszer szintjén történik. Az adatokat naponta 30 percen keresztül 15 másodpercenként kérik le.. Az adatokat naponta 30 percen keresztül 15 másodpercenként kérik le.

A havi adatpontok mennyiségét a következőképpen számítják ki:

240 lekérdezés / óra x 0,5 óra x 30 nap = 3600 adatpont havonta.

Ezenkívül 24 órán keresztül 5 percenként előzmény adatokat kérünk.

A havi adatpontok mennyiségét a következőképpen számoljuk ki:

12 lekérdezés / óra x 5 csatorna x 24 óra x 30 nap = 43 200 adatpont havonta.

Ezenkívül az 5 API-csatornára vonatkozó összesített energiaadatokat a hálózati betáplálás, a hálózati teljesítmény, az akkumulátor töltése, az akkumulátor kisütése és az önfogyasztás tekintetében kérdezik le. A lekérdezés naponta egyszer történik a napi, havi, éves és összesített értékekre vonatkozóan. 

A havi adatpontok mennyiségét a következőképpen számoljuk ki:

1 lekérdezés / nap x 4 időintervallum x 5 csatorna x 30 nap = 600 adatpont havonta.

Ennél a felhasználási esetnél az eredmény összesen 47 400 adatpont havonta. Az alkalmazási példákban kiszámított adatpontok a napelemes rendszerek számától függően megsokszorozhatók. Az adatpontok kiszámítása mindig lineáris.

A 0 és a NULL értékek között különbség van. A 0 azt jelenti, hogy van egy mért érték, de az valójában 0 (pl. az éjszaka termelt teljesítmény 0). A NULL azt jelenti, hogy az adott értékhez nem állnak rendelkezésre adatok. Ez az eset gyakran akkor fordul elő, ha a PV-rendszer nincs csatlakoztatva az internethez. A NULL adatpontok nem számítanak, és ezért nem képezik részét a számlázott összegnek.
Egy lekérdezés nem felel meg automatikusan egy adatpontnak, hanem több adatpontból is állhat. Ez a lekérdezés típusától és a lekérdezett csatornák vagy metaadatok számától függ.

Napelemes rendszer integráció

A Fronius napelemes rendszer adataihoz az API-n keresztül történő hozzáféréshez a tulajdonos hozzájárulása szükséges. A Fronius a felhasználási esettől függően kétféle módszert kínál a hozzájárulás megszerzésére, majd az adatoknak az alkalmazásba történő integrálására:

  • A Solar.web fiókjában hozzáférhet a napelemes rendszerekhez (a legtöbb adat megtekintéséhez elegendő a vendég jogosultság). Ha azonban konkrét napelemes erőművek szervizértesítéseit szeretné megtekinteni, akkor rendszerfelügyelő jogosultságra van szüksége. Felhívjuk figyelmét, hogy a rendszeradatokhoz való hozzáférési engedélyt mindig közvetlenül a napelemes rendszer tulajdonosával vagy rendszerfelügyelőjével kell tisztázni, és ez nem tartozik a Fronius hatáskörébe.
  • Felhasználó megszemélyesítése: Bizonyos alkalmazásoknál érdemes a napelemes rendszereket egy másik felhasználó kontextusában megjeleníteni. Ezekre az esetekre a Solar.web Query API lehetőséget kínál a megszemélyesítésre JSON Web Token (JWT) használatával. A Solar.web Premium funkciókhoz való hozzáférés csak akkor lehetséges, ha a napelemes létesítményt tartalmazó Solar.web felhasználói fiókhoz érvényes Solar.web Premium tagság áll rendelkezésre. 

A megvalósítással kapcsolatos részletes információk, valamint gyakorlati alkalmazási példák az interfész dokumentációjában találhatók.