{"id":6886,"date":"2022-02-21T08:12:59","date_gmt":"2022-02-21T07:12:59","guid":{"rendered":"http:\/\/documentation-wp.hub.av.priv\/aurora-vision-apis\/user-guide\/telemetries-data\/"},"modified":"2022-05-27T09:01:13","modified_gmt":"2022-05-27T08:01:13","slug":"telemetries-data","status":"publish","type":"page","link":"http:\/\/documentation-wp.hub.av.priv\/de\/aurora-vision-apis\/user-guide\/telemetries-data\/","title":{"rendered":"Telemetriedaten"},"content":{"rendered":"\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Die Suiten <code>Telemetry <\/code>und <code>KPIs <\/code>erm\u00f6glichen die Nutzung mehrerer Aufrufe zum Abrufen der gew\u00fcnschten Telemetriedaten, sowohl auf Werks- als auch auf Einzelger\u00e4teebene.<\/p>\n\n\n\n<p>Die APIs in diesen Suiten sind basierend auf der Datenmodellierung und -darstellung in zwei Haupttypen unterteilt:<\/p>\n\n\n\n<ul><li><code>AGGREGATED<\/code>: erm\u00f6glicht den Aufruf des gew\u00fcnschten datentyps (<code>dataType<\/code>) mit einem aggregationskriterium (<code>valueType<\/code>) innerhalb eines definierten zeitfenster (<code>startDate <\/code>&amp; <code>endDate<\/code>). Aufrufe dieses typs geben immer einen einzelnen wert zur\u00fcck, aggregiert gem\u00e4\u00df den definierten <code>queryParameters<\/code>;<br><\/li><li><code>TIMESERIES<\/code>: erm\u00f6glicht den Aufruf des gew\u00fcnschten typs von daten (<code>dataType<\/code>) mit einem aggregationskriterium (<code>valueType<\/code>) innerhalb eines definierten zeitfensters (<code>startDate<\/code> &amp; <code>endDate<\/code>) und nach einer definierten abtastfrequenz (<code>sampleTime<\/code>). Aufrufe dieser art geben immer ein array von werten zur\u00fcck, dessen l\u00e4nge je nach den definierten <code>queryParameters<\/code>.<\/li><\/ul>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>F\u00fcr die entwicklung einer transparenten und vollst\u00e4ndig integrierten gesch\u00e4ftslogik von drittanbietern ist es wichtig, einige schl\u00fcsselprinzipien f\u00fcr die bearbeitung und pr\u00e4sentation von daten von Aurora Vision zu ber\u00fccksichtigen::<\/p>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<div class=\"wp-block-media-text alignwide is-stacked-on-mobile\" style=\"grid-template-columns:30% auto\"><figure class=\"wp-block-media-text__media\"><img loading=\"lazy\" width=\"276\" height=\"277\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/02\/puzzle_missing.png\" alt=\"\" class=\"wp-image-1132 size-full\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/02\/puzzle_missing.png 276w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/02\/puzzle_missing-150x150.png 150w\" sizes=\"(max-width: 276px) 100vw, 276px\" \/><\/figure><div class=\"wp-block-media-text__content\">\n<h2 class=\"has-medium-font-size\">Sampling<br>Time<\/h2>\n<\/div><\/div>\n\n\n\n<p>Aurora Vision f\u00fchrt eine <strong>speicherung von proben durch die mindestens alle 5 Minuten gesendet werden<\/strong><em>,<\/em> daher ist es nicht m\u00f6glich daten unter einer abtastrate von 5 Minuten anzufordern.<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<div class=\"wp-block-media-text alignwide is-stacked-on-mobile\" style=\"grid-template-columns:30% auto\"><figure class=\"wp-block-media-text__media\"><img loading=\"lazy\" width=\"217\" height=\"217\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/export.png\" alt=\"\" class=\"wp-image-5885 size-full\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/export.png 217w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/export-150x150.png 150w\" sizes=\"(max-width: 217px) 100vw, 217px\" \/><\/figure><div class=\"wp-block-media-text__content\">\n<h2 class=\"has-medium-font-size\">Power<br>Data<\/h2>\n<\/div><\/div>\n\n\n\n<p>Alle <strong><strong>stromtelemetrien<\/strong><\/strong> (<em><em>f\u00fcr alle kompatiblen ger\u00e4te<\/em><\/em>) werden <strong>als ein einziger einschaltzeitwert<\/strong>, bereitgestellt, der sich von einem abtastzeitpunkt zu \u00e4ndert ein anderer.<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<div class=\"wp-block-media-text alignwide is-stacked-on-mobile\" style=\"grid-template-columns:38% auto\"><figure class=\"wp-block-media-text__media\"><img loading=\"lazy\" width=\"312\" height=\"245\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/export-Copy.png\" alt=\"\" class=\"wp-image-5896 size-full\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/export-Copy.png 312w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/export-Copy-300x236.png 300w\" sizes=\"(max-width: 312px) 100vw, 312px\" \/><\/figure><div class=\"wp-block-media-text__content\">\n<h2 class=\"has-medium-font-size\">Energy<br>Data<\/h2>\n<\/div><\/div>\n\n\n\n<p>Alle <strong>Energie-Telemetrien<\/strong> (<em>f\u00fcr alle kompatiblen ger\u00e4te<\/em>) werden <strong>im laufe der zeit kumulativ bereitgestellt<\/strong>, ab dem ersten moment, in dem das kompatible ger\u00e4t gestartet wurde um effektiv zu arbeiten.<\/p>\n<\/div>\n<\/div>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Mit diesen Konzepten ist es m\u00f6glich um die beiden haupttypen von telemetrieanrufen im detail zu analysieren:<\/p>\n\n\n\n<ul><li>Auf <strong><strong>Seite <\/strong>2<\/strong> finden sie eine detaillierte analyse der <code>Aggregated<\/code> APIs;<\/li><li>Auf <strong><strong>Seite <\/strong>3<\/strong> finden sie eine detaillierte analyse der <code>Timeseries<\/code> APIs.<\/li><\/ul>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Da die suiten <code>Telemetry <\/code>und <code>KPIs <\/code>viele <code>dataTypes <\/code>bereitstellen, die aufgerufen werden k\u00f6nnen, ist eine vollst\u00e4ndige tabelle mit einer beschreibung f\u00fcr jeden von ihnen unter verf\u00fcgbar <strong>Seite 4<\/strong>.<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<!--nextpage-->\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2>Aggregated APIs<\/h2>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Aggregated APIs werden haupts\u00e4chlich verwendet, wenn sie f\u00fcr einen bestimmten datentyp einen einzelnen wert als antwort erhalten m\u00f6chten, der es erm\u00f6glicht, einen bestimmten trend und\/oder ein bestimmtes ergebnis f\u00fcr ein benutzerdefiniertes zeitfenster zusammenzufassen.<\/p>\n\n\n\n<p>Diese Art von APIs sind immer wie folgt strukturiert:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"62\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/agregated_api_block-1024x62.png\" alt=\"\" class=\"wp-image-6345\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/agregated_api_block-1024x62.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/agregated_api_block-300x18.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/agregated_api_block-768x47.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/agregated_api_block-1536x93.png 1536w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/agregated_api_block-2048x124.png 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Der path, mit dem sie auf die gew\u00fcnschten ressourcen zeigen k\u00f6nnen, erfordert immer die folgenden parameter:<\/p>\n\n\n\n<ul><li><code>{power,frequency,wind,temperature,voltage,current,energy,kpis}<\/code>: der ressourcentyp, auf den verwiesen werden soll. Dieser parameter gibt nicht die eigentlichen daten an, die sie erhalten m\u00f6chten, sondern die allgemeine kategorie, zu der die gew\u00fcnschten daten geh\u00f6ren (<em>bitte beachten sie, dass ein API-Aufruf jeweils nur eine kategorie akzeptiert, es ist derzeit nicht m\u00f6glich, BULK-Aufrufe durchzuf\u00fchren<\/em>);<\/li><li><code>{entityID}<\/code>: es kann sich um eine anlagen-oder Ger\u00e4te-EID handeln. Im ersten fall ber\u00fccksichtigt der erhaltene wert die aggregation aller ger\u00e4te, f\u00fcr die dieser wert existiert, auf anlagenebene; im zweiten fall bezieht sich der erhaltene wert auf das einzelne interessierende ger\u00e4t;<\/li><li><code>{dataType}<\/code>: stellt die tats\u00e4chlich zu erhaltenden daten dar. Die verf\u00fcgbaren <code>dataTypes <\/code>variieren je nach ressource, auf die verwiesen wird, eine detaillierte beschreibung ist direkt in der <a rel=\"noreferrer noopener\" href=\"http:\/\/documentation-wp.hub.av.priv\/aurora-vision-apis\/openapi-preview\/\" data-type=\"page\" data-id=\"74\" target=\"_blank\"><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">OpenAPIs Swagger<\/mark><\/a>;<\/li><li><code>{valuetype}<\/code>: stellt die art des aggregationskriteriums dar, mit dem die angeforderten daten vorliegen zu erhalten.<\/li><\/ul>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Die queries, mit denen sie die angeforderten daten filtern k\u00f6nnen, erfordern immer die folgenden parameter:<\/p>\n\n\n\n<ul><li><code>{startDate}<\/code>: die untere grenze, die es erm\u00f6glicht, den beginn des interessierenden zeitfensters zu definieren. Sein Format ist immer <code>YYYYMMGG <\/code>(<em>eg: 20220321<\/em>);<\/li><li><code>{endDate}<\/code>: die obergrenze, die es erlaubt definieren sie das ende des interessierenden zeitfensters. Sein format ist immer <code>YYYYMMGG <\/code>(<em>eg: 20220322<\/em>) und muss zeitlich nach dem <code>{startDate}<\/code> liegen;<\/li><li><code>{timezone}<\/code>: erm\u00f6glicht es, den API-Aufruf zu einer korrekten datenwiederherstellung gem\u00e4\u00df der angeforderten zeitzone zu leiten.<\/li><\/ul>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Ein aggregataufruf liefert als antwort immer einen einzelwert, der entsprechend dem angegebenen zeitfenster und der angegebenen zeitzone manipuliert wird. In diesem zusammenhang ist der parameter <code>{valuetype}<\/code> von gro\u00dfer bedeutung, da er je nach kategorie der zu erhaltenden ressourcen, also <code>{dataType}<\/code> variiert.<\/p>\n\n\n\n<p>F\u00fcr einen <code>{dataType}<\/code> der zur kategorie <code>{power,frequency,wind,temperature,voltage,current,kpis}<\/code> geh\u00f6rt, wird der<code>{valueType}<\/code> kann drei verschiedene werte annehmen:<\/p>\n\n\n\n<ul><li><code>Maximum<\/code>: gibt den maximalen wert zur\u00fcck, der unter allen in der def vorhandenen proben gefunden wurde <code>{startDate} <\/code>und <code>{endDate}<\/code> zeitfenster, f\u00fcr den angeforderten <code>{dataType}<\/code>;<\/li><li><code>Minimum<\/code>: returns the minimum value found among all the samples present in the defined <code>{startDate} <\/code>und <code>{endDate}<\/code> zeitfenster, f\u00fcr den angeforderten <code>{dataType}<\/code>;<\/li><li><code>Average<\/code>: gibt den durchschnittswert aller stichproben zur\u00fcck, die im definierten <code>{startDate} <\/code>und <code>{endDate}<\/code> tzeitfenster, f\u00fcr den angeforderten <code>{dataType}<\/code>;<\/li><\/ul>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<p><strong>HINWEIS:<\/strong>&nbsp;<em>f\u00fcr die kategorie<\/em><code> kpis<\/code><em>, gelten die obigen \u00dcberlegungen nur, wenn <strong>Power-Based KPIs<\/strong> genannt werden. Weitere einzelheiten finden sie unter<\/em> <a rel=\"noreferrer noopener\" href=\"http:\/\/documentation-wp.hub.av.priv\/aurora-vision-apis\/openapi-preview\/\" data-type=\"page\" data-id=\"74\" target=\"_blank\"><em><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">OpenAPIs Swagger<\/mark><\/em><\/a>.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<p>Werfen wir einen blick auf einige anwendungsf\u00e4lle, in denen wir eine anlage ( <code>entityID<\/code>: <em>12345678 <\/em>) mit einem einzelnen registrierten wechselrichterger\u00e4t ( <code>entityID<\/code> : <em>87654321 <\/em>):<\/p>\n\n\n\n<div class=\"wp-block-columns alignwide\">\n<div class=\"wp-elements-1 wp-block-column has-text-color has-background has-link-color\" style=\"background-color:#eeeeee;color:#000000;padding-top:2em;padding-right:2em;padding-bottom:2em;padding-left:2em\">\n<h2 style=\"font-size:40px\">Anwendungsfall 1<\/h2>\n\n\n\n<p>Ich m\u00f6chte den am tag der Fr\u00fchlings-Tagundnachtgleiche ermittelten maximalwert der von der anlage erzeugten energie erhalten.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<p><strong>Problemanalyse<\/strong><\/p>\n\n\n\n<p>Wenn man bedenkt, dass das verh\u00e4ltnis zwischen anlage und registrierten ger\u00e4ten 1:1 ist, kann ich gleichg\u00fcltig die <code>entityID<\/code> von einem der beiden eingeben. Ich m\u00f6chte, dass der strom produziert wird, also werde ich auf die ressourcen der kategorie <code>power <\/code>verweisen und die <code>GenerationPower<\/code> anfordern.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<h2 class=\"has-text-align-center has-medium-font-size\">Request<\/h2>\n\n\n\n<p><code>GET&nbsp;&nbsp;&nbsp;https:\/\/api.auroravision.net\/api\/rest\/v1\/stats\/power\/aggregated\/12345678\/GenerationPower\/maximum?startDate=20220321&amp;endDate=20220322&amp;timeZone=Europe\/Rome<\/code><\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<h2 class=\"has-text-align-center has-medium-font-size\">Response<\/h2>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"164\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase1-1024x164.png\" alt=\"\" class=\"wp-image-6364\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase1-1024x164.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase1-300x48.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase1-768x123.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase1.png 1147w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-elements-2 wp-block-column has-text-color has-background has-link-color\" style=\"background-color:#eeeeee;color:#000000;padding-top:2em;padding-right:2em;padding-bottom:2em;padding-left:2em\">\n<h2 style=\"font-size:40px\">Anwendungsfall 2<\/h2>\n\n\n\n<p>Ich m\u00f6chte den durchschnittswert aller vom wechselrichter gemessenen spannungen am tag der Fr\u00fchlings-Tagundnachtgleiche erhalten.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<p><strong>Problemanalyse<\/strong><\/p>\n\n\n\n<p>Wenn man bedenkt, dass das verh\u00e4ltnis zwischen anlage und registrierten ger\u00e4ten 1:1 ist, kann ich gleichg\u00fcltig die <code>entityID<\/code> von einem der beiden eingeben. Ich will die spannung, also zeige ich die ressourcen der kategorie <code>voltage <\/code>und fordern die <code>Voltage<\/code>.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<h2 class=\"has-text-align-center has-medium-font-size\">Request<\/h2>\n\n\n\n<p><code>GET&nbsp;&nbsp;&nbsp;https:\/\/api.auroravision.net\/api\/rest\/v1\/stats\/voltage\/aggregated\/87654321\/Voltage\/average?startDate=20220321&amp;endDate=20220322&amp;timeZone=Europe\/Rome<\/code><\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<h2 class=\"has-text-align-center has-medium-font-size\">Response<\/h2>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"160\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase2-1024x160.png\" alt=\"\" class=\"wp-image-6372\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase2-1024x160.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase2-300x47.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase2-768x120.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase2.png 1150w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n<\/div>\n<\/div>\n\n\n\n<div style=\"height:21px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>F\u00fcr einen <code>{dataType}<\/code> der zur kategorie <code>{energy,kpis}<\/code>, geh\u00f6rt, kann der <code>{valueType}<\/code> zwei unterschiedliche werte annehmen:<\/p>\n\n\n\n<ul><li><code>Cumulative<\/code>: gibt den letzten kumulativen wert zur\u00fcck, der im definierten zeitfenster <code>{startDate} <\/code>und <code>{endDate}<\/code>, f\u00fcr die verf\u00fcgbar ist angeforderter <code>{dataType}<\/code>;<\/li><li><code>Delta<\/code>: gibt die differenz zwischen dem letzten und dem ersten kumulativen wert zur\u00fcck, der im definierten <code>{startDate} <\/code>und <code>{endDate}<\/code> zeitfenster, f\u00fcr den angeforderten <code>{dataType}<\/code>;<\/li><\/ul>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<p><strong><strong>HINWEIS<\/strong>:<\/strong>&nbsp;<em><em>f\u00fcr die kategorie<\/em><code> kpis<\/code><em>, gelten die obigen \u00dcberlegungen nur, wenn <strong>Energy-Based KPIs<\/strong> genannt werden. Weitere einzelheiten finden sie unter<\/em><\/em> <a rel=\"noreferrer noopener\" href=\"http:\/\/documentation-wp.hub.av.priv\/aurora-vision-apis\/openapi-preview\/\" data-type=\"page\" data-id=\"74\" target=\"_blank\"><em><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">OpenAPIs Swagger<\/mark><\/em><\/a>.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<p>Werfen wir einen blick auf einige anwendungsf\u00e4lle, in denen wir eine anlage ( <code>entityID<\/code>: <em>12345678 <\/em>) mit einem einzelnen registrierten wechselrichterger\u00e4t ( <code>entityID<\/code> : <em>87654321 <\/em>):<\/p>\n\n\n\n<div class=\"wp-block-columns alignwide\">\n<div class=\"wp-elements-3 wp-block-column has-text-color has-background has-link-color\" style=\"background-color:#eeeeee;color:#000000;padding-top:2em;padding-right:2em;padding-bottom:2em;padding-left:2em\">\n<h2 style=\"font-size:40px\">Anwendungsfall 1<\/h2>\n\n\n\n<p>Ich m\u00f6chte die von der pflanze erzeugte Energie vom beginn der produktion bis zum tag der Fr\u00fchlings-Tagundnachtgleiche erhalten.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<p><strong>Problemanalyse<\/strong><\/p>\n\n\n\n<p>Wenn man bedenkt, dass das verh\u00e4ltnis zwischen anlage und registrierten ger\u00e4ten 1:1 ist, kann ich gleichg\u00fcltig die <code>entityID<\/code> von einem der beiden eingeben. Ich m\u00f6chte die bisher von der anlage produzierte energie, also zeige ich die ressourcen der kategorie <code>energy <\/code>und fordere die <code>cumulative <\/code>der <code>GenerationEnergy<\/code>.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<h2 class=\"has-text-align-center has-medium-font-size\">Request<\/h2>\n\n\n\n<p><code>GET&nbsp;&nbsp;&nbsp;https:\/\/api.auroravision.net\/api\/rest\/v1\/stats\/energy\/aggregated\/12345678\/GenerationEnergy\/cumulative?startDate=20220321&amp;endDate=20220322&amp;timeZone=Europe\/Rome<\/code><\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<h2 class=\"has-text-align-center has-medium-font-size\">Response<\/h2>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"161\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase3-1024x161.png\" alt=\"\" class=\"wp-image-6381\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase3-1024x161.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase3-300x47.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase3-768x121.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase3.png 1146w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-elements-4 wp-block-column has-text-color has-background has-link-color\" style=\"background-color:#eeeeee;color:#000000;padding-top:2em;padding-right:2em;padding-bottom:2em;padding-left:2em\">\n<h2 style=\"font-size:40px\">Anwendungsfall 2<\/h2>\n\n\n\n<p>Ich m\u00f6chte die am tag der Fr\u00fchlings-Tagundnachtgleiche vom wechselrichter erzeugte energie beziehen.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<p><strong>Problemanalyse<\/strong><\/p>\n\n\n\n<p>Wenn man bedenkt, dass das verh\u00e4ltnis zwischen anlage und registrierten ger\u00e4ten 1:1 ist, kann ich gleichg\u00fcltig die <code>entityID<\/code> von einem der beiden eingeben. Ich m\u00f6chte nur die energie, die am tag der Fr\u00fchlings-Tagundnachtgleiche erzeugt wird, also werde ich auf die ressourcen der kategorie <code>energy <\/code>und fordere die <code>delta<\/code> der <code>GenerationEnergy<\/code>.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<h2 class=\"has-text-align-center has-medium-font-size\">Request<\/h2>\n\n\n\n<p><code>GET&nbsp;&nbsp;&nbsp;https:\/\/api.auroravision.net\/api\/rest\/v1\/stats\/energy\/aggregated\/87654321\/GenerationEnergy\/delta?startDate=20220321&amp;endDate=20220322&amp;timeZone=Europe\/Rome<\/code><\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<h2 class=\"has-text-align-center has-medium-font-size\">Response<\/h2>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"156\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase4-1024x156.png\" alt=\"\" class=\"wp-image-6389\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase4-1024x156.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase4-300x46.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase4-768x117.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/aggregated_usecase4.png 1150w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n<\/div>\n<\/div>\n\n\n\n<!--nextpage-->\n\n\n\n<h2>Timeseries APIs<\/h2>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Timeseries APIs werden haupts\u00e4chlich verwendet, wenn sie f\u00fcr einen bestimmten datentyp einen detaillierten trend erhalten m\u00f6chten, der es ihnen erm\u00f6glicht, echtzeitanalysen und-darstellungen f\u00fcr ein benutzerdefiniertes Zeitfenster durchzuf\u00fchren.<\/p>\n\n\n\n<p>Diese art von APIs sind immer wie folgt strukturiert:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"61\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/timeseries_api_block-1024x61.png\" alt=\"\" class=\"wp-image-6353\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/timeseries_api_block-1024x61.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/timeseries_api_block-300x18.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/timeseries_api_block-768x46.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/timeseries_api_block-1536x92.png 1536w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/timeseries_api_block-2048x123.png 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Der path, mit dem sie auf die gew\u00fcnschten ressourcen zeigen k\u00f6nnen, erfordert immer die folgenden parameter:<\/p>\n\n\n\n<ul><li><code>{power,frequency,wind,temperature,voltage,current,energy,kpis}<\/code>:der ressourcentyp, auf den verwiesen werden soll. Dieser parameter gibt nicht die eigentlichen daten an, die sie erhalten m\u00f6chten, sondern die allgemeine kategorie, zu der die gew\u00fcnschten daten geh\u00f6ren (<em>bitte beachten sie, dass ein API-Aufruf jeweils nur eine kategorie akzeptiert, es ist derzeit nicht m\u00f6glich, BULK-Aufrufe durchzuf\u00fchren<\/em>);<\/li><li><code>{entityID}<\/code>: es kann sich um eine anlagen-oder Ger\u00e4te-EID handeln. Im ersten fall ber\u00fccksichtigt der erhaltene wert die aggregation aller ger\u00e4te, f\u00fcr die dieser wert existiert, auf anlagenebene; im zweiten fall bezieht sich der erhaltene wert auf das einzelne interessierende ger\u00e4t;<\/li><li><code>{dataType}<\/code>: stellt die tats\u00e4chlich zu erhaltenden daten dar. Die verf\u00fcgbaren <code>dataTypes <\/code>variieren je nach ressource, auf die verwiesen wird, eine detaillierte beschreibung ist direkt in der <a rel=\"noreferrer noopener\" href=\"http:\/\/documentation-wp.hub.av.priv\/aurora-vision-apis\/openapi-preview\/\" data-type=\"page\" data-id=\"74\" target=\"_blank\"><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">OpenAPIs Swagger<\/mark><\/a>;<\/li><li><code>{valuetype}<\/code>: stellt die art des aggregationskriteriums dar, mit dem die angeforderten daten vorliegen zu erhalten.<\/li><\/ul>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Die queries, mit denen sie die angeforderten daten filtern k\u00f6nnen, erfordern immer die folgenden parameter:<\/p>\n\n\n\n<ul><li><code>{sampleSize}<\/code>: definiert die abtastrate, mit der daten abgerufen werden. Je l\u00e4nger die abtastrate, desto k\u00fcrzer die l\u00e4nge des als antwort erhaltenen datenarrays (<em>a <\/em><code>sampleTime<\/code><em> gleich<\/em><code> Min5<\/code><em> hat mehr Samples im Antwortarray als ein<\/em><code> sampleTime<\/code> <em>gleich<\/em><code> Min15<\/code>);<\/li><li><code>{startDate}<\/code>: die untere grenze, die es erm\u00f6glicht, den beginn des interessierenden zeitfensters zu definieren. Sein Format ist immer <code>YYYYMMGG <\/code>(<em>eg: 20220321<\/em>);<\/li><li><code>{endDate}<\/code>: die obergrenze, die es erlaubt definieren sie das ende des interessierenden zeitfensters. Sein format ist immer <code>YYYYMMGG <\/code>(<em>eg: 20220322<\/em>) und muss zeitlich nach dem <code>{startDate}<\/code> liegen;<\/li><li><code>{timezone}<\/code>: erm\u00f6glicht es, den API-Aufruf zu einer korrekten datenwiederherstellung gem\u00e4\u00df der angeforderten zeitzone zu leiten.<\/li><\/ul>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Ein Timeseries-Aufruf liefert normalerweise ein array von werten als antwortarray of values as response.<br>Die l\u00e4nge des arrays h\u00e4ngt direkt vom <code>{sampleSize}<\/code> wert und vom durch <code>{startDate}<\/code> und <code>{endDate}<\/code> definierten zeitfenster ab. Sobald ein referenzzeitfenster definiert wurde, wird der wert <code>{sampleSize}<\/code> dieses fenster mehr oder weniger h\u00e4ufig aufteilen, wodurch folglich die l\u00e4nge des arrays als antwort ge\u00e4ndert wird: je gr\u00f6\u00dfer der <code>{sampleSize}<\/code> desto sp\u00e4rlicher wird das zeitfenster aufgeteilt, was zu weniger elementen im antwortarray f\u00fchrt.<br>Es lohnt sich, sich ein direktes beispiel anzusehen, um diese konzepte besser zu erkl\u00e4ren.<\/p>\n\n\n\n<div class=\"wp-block-columns alignwide\">\n<div class=\"wp-elements-5 wp-block-column has-text-color has-background has-link-color\" style=\"background-color:#eeeeee;color:#000000;padding-top:2em;padding-right:2em;padding-bottom:2em;padding-left:2em\">\n<h2 class=\"has-medium-font-size\">Beispiel<\/h2>\n\n\n\n<p>Nehmen wir an, wir m\u00f6chten den echtzeittrend der von einem wechselrichter w\u00e4hrend des aktuellen tages erzeugten leistung darstellen (<em>suppose we are in the spring equinox<\/em>). The best solution is to use a Timeseries API, which will have the following general structure:<\/p>\n\n\n\n<p><code>https:\/\/api.auroravision.net\/api\/rest\/v1\/stats\/{power,frequency,wind,temperature,voltage,current,energy,kpis}\/timeseries\/12345678\/{dataType}\/{valueType}?{sampleSize}&amp;{startDate}&amp;{endDate}&amp;{timeZone}<\/code><\/p>\n\n\n\n<p>Innerhalb der obigen generischen struktur wissen wir folgendes:<\/p>\n\n\n\n<ol><li>Die anzustrebende ressourcenkategorie ist <code>{power}<\/code> und innerhalb dieser kategorie <code>{dataType}<\/code> ist  <code>GenerationPower<\/code>;<\/li><li>Der aufzurufende <code><code>{valueType} <\/code><\/code>ist entweder<code> Maximum<\/code>, <code>Minimum<\/code> und <code>Average<\/code> <em>(siehe detaillierte analyse weiter unten<\/em>);<\/li><li>Das zeitfenster ist der tag der fr\u00fchlings-tagundnachtgleiche, also <code>{startDate}<\/code> ist 20220321 und <code>{endDate}<\/code> ist 20220322;<\/li><\/ol>\n\n\n\n<p>Dies f\u00fchrt dazu, dass unser aufruf die folgende form annimmt:<\/p>\n\n\n\n<p><code>https:\/\/api.auroravision.net\/api\/rest\/v1\/stats\/power\/timeseries\/12345678\/GenerationPower\/average?{sampleSize}&amp;startDate=20220321&amp;endDate=20220322&amp;{timeZone}<\/code><\/p>\n\n\n\n<p>Der parameter <code>{sampleSize}<\/code> kann die folgenden werte haben:<\/p>\n\n\n\n<ul><li><code>Min5<\/code>: das zeitfenster wird alle 5 minuten geschnitten, wobei jede einzelne probe genommen wird, die auf Aurora Vision gespeichert ist (<em>iehe Seite 1<\/em>);<\/li><li><code>Min15<\/code>: das zeitfenster wird alle 15 minuten geschnitten, 3 Aurora Vision-samples sind f\u00fcr jede scheibe enthalten;<\/li><li><code>Min30<\/code>: das zeitfenster wird alle 30 minuten geschnitten, 6 Aurora Vision-samples sind f\u00fcr jede scheibe enthalten;<\/li><li><code>Hour<\/code>: das zeitfenster wird alle 60 minuten geschnitten, 12 Aurora Vision-samples sind f\u00fcr jede scheibe enthalten;<\/li><li><code>Day<\/code>: das zeitfenster wird jeden tag geschnitten, 288 Aurora Vision-samples sind f\u00fcr jeden scheibe enthalten;<\/li><li><code>Month<\/code>: das zeitfenster wird jeden monat aufgeteilt;<\/li><li><code>Year<\/code>: das zeitfenster wird jedes jahr aufgeteilt.<\/li><\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"576\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/sampling_chart-1-1024x576.jpg\" alt=\"\" class=\"wp-image-6465\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/sampling_chart-1-1024x576.jpg 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/sampling_chart-1-300x169.jpg 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/sampling_chart-1-768x432.jpg 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/sampling_chart-1.jpg 1280w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Da wir daran interessiert sind, den leistungstrend so oft wie m\u00f6glich in echtzeit darzustellen, setzen wir <code>{sampleSize}<\/code> auf <code>Min5<\/code> (<em>es w\u00e4re nicht sinnvoll, einen wert einzugeben, der gr\u00f6\u00dfer ist als der des gew\u00e4hlten zeitfensters<\/em>) und den parameter <code>{timeZone}<\/code> auf <code>Europe\/Rome<\/code> zu setzen:<\/p>\n\n\n\n<p><code>https:\/\/api.auroravision.net\/api\/rest\/v1\/stats\/<code>power<\/code>\/timeseries\/12345678\/GenerationPower\/average?<code>sampleSize=Min5<\/code>&amp;startDate=20220321&amp;<code>endDate=20220322<\/code>&amp;timeZone=Europe\/Rome<\/code><\/p>\n\n\n\n<p>Die antwort wird ein array einer bestimmten l\u00e4nge sein, in dem jedes element immer aus der folgenden struktur besteht:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"93\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/array_element-1024x93.png\" alt=\"\" class=\"wp-image-6288\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/array_element-1024x93.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/array_element-300x27.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/array_element-768x70.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/array_element-1536x140.png 1536w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/array_element.png 2024w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Wie wir sehen k\u00f6nnen, besteht die antwort aus:<\/p>\n\n\n\n<ul><li><code>Start<\/code>: stellt die Epoch dar, die der zeitwert in UTC ist; \u00e4ndert sich gem\u00e4\u00df der <code>timeZone <\/code>(<em>verschiedene zeitzonen haben unterschiedliche epochen f\u00fcr denselben leistungswert<\/em>) und folgt den durch <code>sampleSize<\/code> definierten zeitlichen abschnitten;<\/li><li><code>Units<\/code>: stellt die ma\u00dfeinheit dar;<\/li><li><code>Value<\/code>: stellt den wert dar.<\/li><\/ul>\n\n\n\n<p>Extrapolieren wir einen gr\u00f6\u00dferen auszug aus der antwort:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"218\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/array_elements_-1024x218.png\" alt=\"\" class=\"wp-image-6303\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/array_elements_-1024x218.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/array_elements_-300x64.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/array_elements_-768x164.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/array_elements_-1536x328.png 1536w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/array_elements_-2048x437.png 2048w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Da feld <code>start <\/code>erh\u00f6ht sich von element zu element und geht von einem wert von <code>1647875700<\/code> zu einem wert von <code>1647876000<\/code> \u00fcber; Wenn wir die differenz zwischen den beiden Epoch machen, erhalten wir genau 5 minuten oder anders ausgedr\u00fcckt den wert, den wir f\u00fcr den parameter <code>sampleSize <\/code>eingestellt haben.<br>Von epoch <code>1647876000<\/code> die felder <code>start <\/code>und <code>value <\/code>existieren nicht mehr; denn unter der annahme, dass der anruf vor 16:20 (<em>Europe\/Rome<\/em>) erfolgt ist, <\/p>\n\n\n\n<p>Da feld <code>start <\/code>erh\u00f6ht sich von element zu element und geht von einem wert von <code>1647875700<\/code> zu einem wert von <code>1647876000<\/code> \u00fcber; Wenn wir die differenz zwischen den beiden Epoch machen, erhalten wir genau 5 minuten oder anders ausgedr\u00fcckt den wert, den wir f\u00fcr den parameter <code>sampleSize <\/code>eingestellt haben.<br>Von epoch <code>1647876000<\/code> die felder <code>start <\/code>und <code>value <\/code>existieren nicht mehr; denn unter der annahme, dass der anruf vor 16:20 (<em>Europe\/Rome<\/em>) erfolgt ist,liegt das mit dieser Epoch bezeichnete sample in der zukunft und existiert daher noch nicht. Als solches stellt Aurora Vision das feld innerhalb des Elements nicht bereit; Bei einem neuen anruf nach 16:20 wird es jedoch bereitgestellt, da es ausgef\u00fcllt wurde.<\/p>\n<\/div>\n<\/div>\n\n\n\n<p>Das prinzip des vorhandenseins\/fehlens bestimmter felder in den antwortelementen einer zeitreihen-API (<em>in den letzten zeilen des obigen beispiels ausgedr\u00fcckt<\/em>) ist von grundlegender bedeutung: es gilt nicht nur in. Bei zuk\u00fcnftigen mustern, aber auch und vor allem bei v\u00f6lligem fehlen von daten zu Aurora Vision. Dies erm\u00f6glicht es, den von den Telemetrie-APIs erhaltenen antworten koh\u00e4renz zu verleihen, denn wenn der <code>value <\/code>abgelegt ist, bedeutet dies, dass dieser wert tats\u00e4chlich auf Aurora Vision vorhanden ist, andernfalls w\u00e4re er nicht vorhanden.<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Wie bei aggregierten aufrufen ist auch bei zeitreihenaufrufen der Parameter <code>{valuetype}<\/code> on gro\u00dfer bedeutung, da er je nach ressourcenkategorie, also <code>{dataType}<\/code>, zu erhalten und wird auch von <code>{sampleSize}<\/code> beeinflusst.<\/p>\n\n\n\n<p>F\u00fcr einen <code>{dataType}<\/code> der zur kategorie <code>{power,frequency,wind,temperature,voltage,current,kpis}<\/code> geh\u00f6rt, wird der <code>{valueType}<\/code> annehmen kann drei verschiedene werte:<\/p>\n\n\n\n<ul><li><code>Maximum<\/code>: gibt den maximalen wert zur\u00fcck, der unter allen samples in jedem zeitabschnitt gefunden wurde, bestimmt durch den <code>{sampleSize}<\/code>, wert im definierten <code>{startDate} <\/code>und <code>{endDate}<\/code> zeitfenster, f\u00fcr den angeforderten <code>{dataType}<\/code>;<\/li><li><code>Minimum<\/code>: gibt den kleinsten wert zur\u00fcck, der unter allen samples in jedem zeitabschnitt gefunden wurde, bestimmt durch den <code>{sampleSize}<\/code>, wert im definierten <code>{startDate} <\/code>und <code>{endDate}<\/code> zeitfenster, f\u00fcr den angeforderten <code>{dataType}<\/code>;<\/li><li><code>Average<\/code>: gibt den durchschnittswert aller samples in jedem zeitabschnitt zur\u00fcck, bestimmt durch den <code>{sampleSize}<\/code>, wert im definierten <code>{startDate} <\/code>und <code>{endDate}<\/code> zeitfenster, f\u00fcr den angeforderten <code>{dataType}<\/code><\/li><\/ul>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<p><strong>HINWEIS:<\/strong>\u00a0<em>f\u00fcr die kategorie<\/em><code> kpis<\/code><em>, gelten die obigen \u00dcberlegungen nur, wenn <strong>Power-Based KPIs<\/strong> genannt werden. Weitere einzelheiten finden sie unter<\/em> <a rel=\"noreferrer noopener\" href=\"http:\/\/documentation-wp.hub.av.priv\/aurora-vision-apis\/openapi-preview\/\" data-type=\"page\" data-id=\"74\" target=\"_blank\"><em><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">OpenAPIs Swagger<\/mark><\/em><\/a>.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<p>Werfen wir einen blick auf einige anwendungsf\u00e4lle, in denen wir eine anlage ( <code>entityID<\/code>: <em>12345678 <\/em>) mit einem einzelnen registrierten wechselrichterger\u00e4t ( <code>entityID<\/code>: <em>87654321 <\/em>):<\/p>\n\n\n\n<div class=\"wp-block-columns alignwide\">\n<div class=\"wp-elements-6 wp-block-column has-text-color has-background has-link-color\" style=\"background-color:#eeeeee;color:#000000;padding-top:2em;padding-right:2em;padding-bottom:2em;padding-left:2em\">\n<h2 style=\"font-size:40px\">Anwendungsfall 1<\/h2>\n\n\n\n<p>Ich m\u00f6chte den vom wechselrichter erzeugten strom alle 5 minuten am tag der fr\u00fchlings-Tagundnachtgleiche in echtzeit abrufen. auf diese weise kann ich den Trend darstellen und spezifische analysen dazu durchf\u00fchren.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<p><strong>Problemanalyse<\/strong><\/p>\n\n\n\n<p>Wenn man bedenkt, dass das verh\u00e4ltnis zwischen anlage und registrierten ger\u00e4ten 1:1 ist, kann ich gleichg\u00fcltig die <code>entityID<\/code> von einem der beiden eingeben. Ich m\u00f6chte, dass der strom produziert wird, also werde ich auf die ressourcen der Kategorie <code>power <\/code>erweisen und die <code>GenerationPower<\/code>. Der parameter <code>sampleSize <\/code>ist gleich <code>Min5 <\/code>, da ich jedes einzelne sample erhalten m\u00f6chte. Der Parameter <code>valueType <\/code>kann nur in diesem fall wegen der zeit gleichg\u00fcltig als <code>Maximum<\/code>, <code>Minimum <\/code>oder <code>Average <\/code>gesetzt werden das fenster wird so aufgeteilt, dass es f\u00fcr jeden schnitt ein einzelnes sample hat, und daher macht kein tats\u00e4chlicher vorgang einen unterschied, wenn es ein einzelnes sample als referenz gibt.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<h2 class=\"has-text-align-center has-medium-font-size\">Request<\/h2>\n\n\n\n<p><code>GET&nbsp;&nbsp;&nbsp;https:\/\/api.auroravision.net\/api\/rest\/v1\/stats\/power\/timeseries\/12345678\/GenerationPower\/average?sampleSize=Min5&amp;startDate=20220321&amp;endDate=20220322&amp;timeZone=Europe\/Rome<\/code><\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<h2 class=\"has-text-align-center has-medium-font-size\">Charted Response<\/h2>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"576\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/chart_usecase1-1024x576.png\" alt=\"\" class=\"wp-image-6413\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/chart_usecase1-1024x576.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/chart_usecase1-300x169.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/chart_usecase1-768x432.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/chart_usecase1.png 1280w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-elements-7 wp-block-column has-text-color has-background has-link-color\" style=\"background-color:#eeeeee;color:#000000;padding-top:2em;padding-right:2em;padding-bottom:2em;padding-left:2em\">\n<h2 style=\"font-size:40px\">Anwendungsfall 2<\/h2>\n\n\n\n<p>Ich m\u00f6chte die durchschnittliche leistung abrufen, die der wechselrichter alle 15\u00a0minuten am tag der fr\u00fchlings-tagundnachtgleiche erzeugt. Auf diese weise kann ich den trend darstellen und spezifische analysen dazu durchf\u00fchren.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<p><strong>Problemanalyse<\/strong><\/p>\n\n\n\n<p>Wenn man bedenkt, dass das verh\u00e4ltnis zwischen anlage und registrierten ger\u00e4ten 1:1 ist, kann ich gleichg\u00fcltig die <code>entityID<\/code> von einem der beiden eingeben. Ich m\u00f6chte, dass der strom produziert wird, also werde ich auf die ressourcen der Kategorie <code>power <\/code>erweisen und die <code>GenerationPower<\/code>. Der parameter <code>sampleSize <\/code>ist gleich <code>Min15<\/code>. Der parameter <code>valueType <\/code>muss <code>Average <\/code>sein, da das zeitfenster so aufgeteilt wird, dass es 3 abtastwerte f\u00fcr jeden abschnitt hat und daher der mittelwert f\u00fcr die 3 abtastwerte durchgef\u00fchrt wird die zu jedem slice geh\u00f6ren.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<h2 class=\"has-text-align-center has-medium-font-size\">Request<\/h2>\n\n\n\n<p><code>GET&nbsp;&nbsp;&nbsp;https:\/\/api.auroravision.net\/api\/rest\/v1\/stats\/power\/timeseries\/12345678\/GenerationPower\/average?sampleSize=Min15&amp;startDate=20220321&amp;endDate=20220322&amp;timeZone=Europe\/Rome<\/code><\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<h2 class=\"has-text-align-center has-medium-font-size\">Charted Response<\/h2>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"576\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/chart_usecase2-1024x576.png\" alt=\"\" class=\"wp-image-6433\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/chart_usecase2-1024x576.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/chart_usecase2-300x169.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/chart_usecase2-768x432.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/chart_usecase2.png 1280w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n<\/div>\n<\/div>\n\n\n\n<div style=\"height:21px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>F\u00fcr einen <code>{dataType}<\/code> der zur kategorie <code>{energy,kpis}<\/code>, geh\u00f6rt, kann der <code>{valueType}<\/code> zwei unterschiedliche werte annehmen:<\/p>\n\n\n\n<ul><li><code>Cumulative<\/code>: gibt den letzten kumulativen wert zur\u00fcck, der in jedem zeitabschnitt verf\u00fcgbar ist, bestimmt durch den wert <code>{sampleSize}<\/code>, im definierten <code>{startDate} <\/code>und <code>{endDate}<\/code> zeitfenster, f\u00fcr den angeforderten <code>{dataType}<\/code>;<\/li><li><code>Delta<\/code>: gibt das zur\u00fcck unterschied zwischen dem letzten und dem ersten kumulativen wert, der in jedem zeitabschnitt verf\u00fcgbar ist, bestimmt durch den wert <code>{sampleSize}<\/code>, im definierten <code>{startDate} <\/code>und <code>{endDate}<\/code> zeitfenster, f\u00fcr den angeforderten <code>{dataType}<\/code>;<\/li><\/ul>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<p><em><strong><strong>HINWEIS<\/strong>:<\/strong>\u00a0<em><em>f\u00fcr die kategorie<\/em><code> kpis<\/code><em>, gelten die obigen \u00dcberlegungen nur, wenn <strong>Energy-Based KPIs<\/strong> genannt werden. Weitere einzelheiten finden sie unter<\/em><\/em> <a rel=\"noreferrer noopener\" href=\"http:\/\/documentation-wp.hub.av.priv\/aurora-vision-apis\/openapi-preview\/\" data-type=\"page\" data-id=\"74\" target=\"_blank\"><em><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">OpenAPIs Swagger<\/mark><\/em><\/a>.<\/em><\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<p>Werfen wir einen blick auf einige anwendungsf\u00e4lle, in denen wir eine anlage ( <code>entityID<\/code>: <em>12345678 <\/em>) mit einem einzelnen registrierten wechselrichterger\u00e4t ( <code>entityID<\/code>: <em>87654321 <\/em>):<\/p>\n\n\n\n<div class=\"wp-block-columns alignwide\">\n<div class=\"wp-elements-8 wp-block-column has-text-color has-background has-link-color\" style=\"background-color:#eeeeee;color:#000000;padding-top:2em;padding-right:2em;padding-bottom:2em;padding-left:2em\">\n<h2 style=\"font-size:40px\">Anwendungsfall 1<\/h2>\n\n\n\n<p>Ich m\u00f6chte die vom wechselrichter erzeugte energie alle 5 minuten am tag der fr\u00fchlings-tagundnachtgleiche in echtzeit abrufen; um den energietrend aufzuzeichnen.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<p><strong>Problemanalyse<\/strong><\/p>\n\n\n\n<p>Wenn man bedenkt, dass das verh\u00e4ltnis zwischen anlage und registrierten ger\u00e4ten 1:1 ist, kann ich gleichg\u00fcltig die <code>entityID<\/code> von einem der beiden eingeben. Ich m\u00f6chte die erzeugte energie, also zeige ich die ressourcen der kategorie <code>energy <\/code>und fordere die <code>GenerationEnergy<\/code>. Der parameter <code>sampleSize <\/code>ist gleich <code>Min5 <\/code>, da ich jedes einzelne sample erhalten m\u00f6chte. Der parameter <code>valueType <\/code>ist gleich <code>delta<\/code> da das zeitfenster so unterteilt wird, dass es f\u00fcr jeden abschnitt ein einzelnes sample und daher die differenz zwischen den samples gibt liefert die in den 5 minuten tats\u00e4chlich erzeugte energie.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<h2 class=\"has-text-align-center has-medium-font-size\">Request<\/h2>\n\n\n\n<p><code>GET&nbsp;&nbsp;&nbsp;https:\/\/api.auroravision.net\/api\/rest\/v1\/stats\/energy\/timeseries\/12345678\/GenerationEnergy\/delta?sampleSize=Min5&amp;startDate=20220321&amp;endDate=20220322&amp;timeZone=Europe\/Rome<\/code><\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<h2 class=\"has-text-align-center has-medium-font-size\">Response<\/h2>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"576\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/energy_usecase1-1-1024x576.png\" alt=\"\" class=\"wp-image-6499\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/energy_usecase1-1-1024x576.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/energy_usecase1-1-300x169.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/energy_usecase1-1-768x432.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/energy_usecase1-1.png 1280w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n<\/div>\n\n\n\n<div class=\"wp-elements-9 wp-block-column has-text-color has-background has-link-color\" style=\"background-color:#eeeeee;color:#000000;padding-top:2em;padding-right:2em;padding-bottom:2em;padding-left:2em\">\n<h2 style=\"font-size:40px\">Anwendungsfall 2<\/h2>\n\n\n\n<p>Ich m\u00f6chte die vom wechselrichter erzeugte energie f\u00fcr jeden tag der woche der fr\u00fchlings-tagundnachtgleiche abrufen, um den w\u00f6chentlichen energietrend aufzuzeichnen.<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<p><strong>Problemanalyse<\/strong><\/p>\n\n\n\n<p>Wenn man bedenkt, dass das verh\u00e4ltnis zwischen anlage und registrierten ger\u00e4ten 1:1 ist, kann ich gleichg\u00fcltig die <code>entityID<\/code> von einem der beiden eingeben. Ich m\u00f6chte, dass die energie an jedem einzelnen tag der woche der fr\u00fchlings-tagundnachtgleiche erzeugt wird, also werde ich auf die ressourcen der kategorie <code>energy <\/code>verweisen und die <code>GenerationEnergy<\/code>. Der parameter <code>sampleSize <\/code>ist gleich <code>Day<\/code>, weil ich das zeitfenster jeden einzelnen tag der woche aufteilen m\u00f6chte. Der parameter <code>valueType <\/code>ist gleich <code>delta<\/code> da das zeitfenster so unterteilt ist, dass die differenz zwischen dem ersten und dem letzten abtastwert jedes wochentags (<em>zeitfenster<\/em>).<\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<h2 class=\"has-text-align-center has-medium-font-size\">Request<\/h2>\n\n\n\n<p><code>GET&nbsp;&nbsp;&nbsp;https:\/\/api.auroravision.net\/api\/rest\/v1\/stats\/energy\/timeseries\/87654321\/GenerationEnergy\/delta?sampleSize=Day?startDate=20220321&amp;endDate=20220327&amp;timeZone=Europe\/Rome<\/code><\/p>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<h2 class=\"has-text-align-center has-medium-font-size\">Response<\/h2>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" width=\"1024\" height=\"576\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/energy_usecase2-1024x576.png\" alt=\"\" class=\"wp-image-6508\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/energy_usecase2-1024x576.png 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/energy_usecase2-300x169.png 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/energy_usecase2-768x432.png 768w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/03\/energy_usecase2.png 1280w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n<\/div>\n<\/div>\n\n\n\n<!--nextpage-->\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h2>Data Types Beschreibungs Tabelle<\/h2>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>Zum besseren verst\u00e4ndnis der Art der messung, die mit dem zur ververbunden ist, kann auf die abbildung verwiesen werden  (<em>die ein allgemeines schema einer vollst\u00e4ndigen anlage bietet<\/em>) und tabelle unten (<em>nur auf Englisch verf\u00fcgbar<\/em>).<\/p>\n\n\n\n<div style=\"height:20px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-image size-full is-resized is-style-default\"><img loading=\"lazy\" src=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/telemetries_diagram.jpg\" alt=\"\" class=\"wp-image-6796\" width=\"1176\" height=\"632\" srcset=\"http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/telemetries_diagram.jpg 1176w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/telemetries_diagram-300x161.jpg 300w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/telemetries_diagram-1024x550.jpg 1024w, http:\/\/documentation-wp.hub.av.priv\/wp-content\/uploads\/2022\/04\/telemetries_diagram-768x413.jpg 768w\" sizes=\"(max-width: 1176px) 100vw, 1176px\" \/><\/figure>\n\n\n\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><strong>Category<\/strong><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><strong>dataType Name<\/strong><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><strong>dataType Description<\/strong><\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">Power (W)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>GenerationPower<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">Power generated by the inverter on the AC side. Includes battery discharge power contribution.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns are-vertically-aligned-center\">\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">Power (W)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>DCGenerationPower<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">Power generated by the inverter on the DC side. Does not include battery discharge power contribution.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Power (W)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>GridPowerExport<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Exported\/Imported power, to\/from the grid, detected by a meter. Negative value for import, positive value for export.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Power (W\/m<sup>2<\/sup> )<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>Irradiance<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Irradiance detected by a sensor, standalone or integrated in a weather station, correctly installed.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Power (W)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>StoredPower<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Discharged\/Charged power detected by a battery. Negative value for charge, positive value for discharge.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Frequency (Hz)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>LineFrequency<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Frequency measured by the inverter on the AC side.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Wind (\u00b0N)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>WindDirection<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Wind direction detected by a sensor, standalone or integrated in a weather station, correctly installed.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Wind (km\/h)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>WindSpeed<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Wind speed detected by a sensor, standalone or integrated in a weather station, correctly installed.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Temperature (\u00b0C)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>CellTemp<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Cell temperature detected by a sensor, standalone or integrated in a weather station, correctly installed.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Temperature (\u00b0C)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>AmbientTemp<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Ambient temperature detected by a sensor, standalone or integrated in a weather station, correctly installed.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Voltage (V)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>Voltage<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Voltage measured by the inverter on the AC side.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Voltage (V)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>DCVoltage<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Frequency measured by the inverter on the DC side.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Current (A)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>Current<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Current measured by the inverter on the AC side.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Current (A)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>DCCurrent<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Current measured by the inverter on the AC side.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Energy (Wh)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>GenerationEnergy<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Energy generated by the inverter on the AC side. Includes battery discharge energy contribution.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Energy (Wh)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>DCGenerationEnergy<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Energy generated by the inverter on the DC side. Does not include battery discharge energy contribution.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Energy (Wh\/m<sup>2<\/sup>)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>Insolation<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Insolation detected by a sensor, standalone or integrated in a weather station, correctly installed.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Energy (Wh)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>StorageInEnergy<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Charged energy detected by a battery.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Energy (Wh)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>StorageOutEnergy<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Discharged energy detected by a battery.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Energy (Wh)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>GridEnergyExport<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Exported energy, to the grid, detected by a meter.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns are-vertically-aligned-center\">\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">Energy (Wh)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\"><code>GridEnergyImport<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column is-vertically-aligned-center\">\n<p class=\"has-text-align-center\">Imported energy, to the grid, detected by a meter.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Energy (Wh)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>SelfConsumedEnergy<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Self-Consumption of home loads, coming from renewable sources only.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Power-Based KPI (%)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>StateofCharge<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">State of charge detected for a battery.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Power-Based KPI (%)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>StateofHealth<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">State of health detected for a battery.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Power-Based KPI (W)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>LoadsPowerConsumed<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Consumption of home loads, coming from renewable sources and the grid.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Energy-Based KPI (%)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>SelfConsumption<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Percentage of Self-Comsumption<em> (how much energy<\/em>, co<em>ming only from renewable sources, has been exported to the grid compared to the self-consumed one<\/em>) detected.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Energy-Based KPI (%)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>SelfSufficiency<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Percentage of Self-Sufficiency <em>(how much energy<\/em> <em>has been imported from the grid compared to the self-consumed one<\/em>) detected.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Energy-Based KPI (%)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>PerformanceRatio<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Percentage of performance detected based on the algorithm set.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Energy-Based KPI (Wh)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>LoadsEnergyConsumed<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Consumption of home loads, coming from renewable sources and the grid.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Power (W)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>ActivePowerEV<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Power generated by the AC wallbox. Different from zero only during a charging session.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Energy (Wh)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>SessionEnergyEV<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Total energy flowed from the AC wallbox during a charging session.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n\n\n\n<div class=\"wp-block-columns\">\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Energy (Wh)<\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\"><code>ActiveEnergyEV<\/code><\/p>\n<\/div>\n\n\n\n<div class=\"wp-block-column\">\n<p class=\"has-text-align-center\">Total energy flowed from the AC wallbox over the lifetime.<\/p>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator is-style-wide\"\/>\n","protected":false},"excerpt":{"rendered":"<p>Die Suiten Telemetry und KPIs erm\u00f6glichen die Nutzung mehrerer Aufrufe zum Abrufen der gew\u00fcnschten Telemetriedaten, sowohl auf Werks- als auch auf Einzelger\u00e4teebene. Die APIs in diesen Suiten sind basierend auf der Datenmodellierung und -darstellung in zwei Haupttypen unterteilt: AGGREGATED: erm\u00f6glicht den Aufruf des gew\u00fcnschten datentyps (dataType) mit einem aggregationskriterium (valueType) innerhalb eines definierten zeitfenster (startDate [&hellip;]<\/p>\n","protected":false},"author":4,"featured_media":0,"parent":1792,"menu_order":7,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/pages\/6886"}],"collection":[{"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/comments?post=6886"}],"version-history":[{"count":228,"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/pages\/6886\/revisions"}],"predecessor-version":[{"id":8545,"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/pages\/6886\/revisions\/8545"}],"up":[{"embeddable":true,"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/pages\/1792"}],"wp:attachment":[{"href":"http:\/\/documentation-wp.hub.av.priv\/de\/wp-json\/wp\/v2\/media?parent=6886"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}