Datenexport & API (de)

Übersicht

Dieser Referenzartikel beschreibt alle Messwerte, die über den Datenexport (CSV) und die API verfügbar sind. Die Messwerte sind in zwei Kategorien unterteilt:

Universelle Messwerte — werden für alle elektrischen Geräte zurückgegeben, einschließlich Stromsensoren und Leistungsmessgeräte.
Leistungsmessgerät-Messwerte — werden ausschließlich für Leistungsmessgeräte zurückgegeben und bieten erweiterte elektrische Messungen.

Hinweis: Wenn eine Spalte in Ihrem Export erscheint, aber NULL-Werte anzeigt, überprüfen Sie, ob Ihr Gerät ein Leistungsmessgerät ist und ob der betreffende Messtyp von Ihrer Hardwarekonfiguration unterstützt wird.

Universelle Messwerte

Die folgenden Messwerte werden für alle elektrischen Geräte sowohl in CSV-Exporten als auch in API-Antworten zurückgegeben.

Spaltenname	Beschreibung
`external_id`	Eine eindeutige Kennung, die dem ausgewählten Asset zugewiesen ist. Wird verwendet, um das Gerät in externen Systemen und Integrationen zu referenzieren.
`asset_name`	Der Name des Assets, wie er in der Plattform konfiguriert ist.
`Customer`	Der Name des Kundenstandorts, zu dem das Asset gehört.
`time_zone`	Die Zeitzone, in der sich das Asset befindet. Siehe hier für eine vollständige Liste der unterstützten Zeitzonenkennungen und deren Beschreibungen.
`measured_at`	Der Zeitstempel der Messung in Ortszeit (basierend auf der konfigurierten Zeitzone des Assets).
`utc_time`	Der Zeitstempel der Messung in koordinierter Weltzeit (UTC).
`power`	Gemessene Wirkleistung. Dieses Feld enthält immer einen Wert — wenn keine Messung vom Gerät empfangen wurde, wird standardmäßig 0 eingetragen. Bei Stromsensoren ist dies ein berechneter Wert, der aus dem gemessenen Strom, dem konfigurierten Leistungsfaktor und der konfigurierten Spannung abgeleitet wird. Bei Leistungsmessgeräten wird dieser Wert direkt vom Gerät gemessen.
`energy`	Berechnete Energie. Direkt aus dem gemessenen oder berechneten Leistungswert über die Zeit abgeleitet.

Leistungsmessgerät-Messwerte

Die folgenden Messwerte werden nur für Leistungsmessgeräte zurückgegeben. Sie erscheinen nicht in Exporten von Stromsensoren. Einige Felder können NULL-Werte enthalten, wenn ein bestimmter Messtyp von der angeschlossenen Hardware nicht unterstützt wird.

Spaltenname	Beschreibung
`active_power_total`	Gemessene Wirkleistung. Entspricht dem Feld power, zeigt jedoch fehlende Werte (NULLs) an, wenn keine Messung vom Gerät empfangen wurde.
`apparent_power_total`	Gemessene Scheinleistung. Stellt die gesamte im Stromkreis fließende Leistung dar, einschließlich aktiver und reaktiver Komponenten.
`reactive_power_total`	Gemessene Blindleistung. Stellt den Anteil der Leistung dar, der keine nützliche Arbeit verrichtet.
`current_l1`	Gemessener Strom auf Phase 1 (L1).
`current_l2`	Gemessener Strom auf Phase 2 (L2).
`current_l3`	Gemessener Strom auf Phase 3 (L3).
`current_n`	Gemessener Neutralleiterstrom.
`current_total`	Der äquivalente Dreiphasen-Linienstrom. Berechnet als: apparent_power_total ÷ (√3 × voltage_ll_average).
`power_factor_total`	Gemessener Leistungsfaktor (Bereich -1 bis 1). Stellt das Verhältnis von Wirkleistung zu Scheinleistung dar. Ein Wert von 1 oder -1 zeigt eine rein resistive Last an; Werte näher an 0 weisen auf einen geringeren Blindleistungsanteil hin.
`voltage_average`	Durchschnittliche Leiter-Neutralleiter-Spannung über alle Phasen.
`voltage_l1_l2`	Gemessene Leiter-Leiter-Spannung zwischen Phase 1 (L1) und Phase 2 (L2).
`voltage_l1_n`	Gemessene Leiter-Neutralleiter-Spannung auf Phase 1 (L1).
`voltage_l2_l3`	Gemessene Leiter-Leiter-Spannung zwischen Phase 2 (L2) und Phase 3 (L3).
`voltage_l2_n`	Gemessene Leiter-Neutralleiter-Spannung auf Phase 2 (L2).
`voltage_l3_l1`	Gemessene Leiter-Leiter-Spannung zwischen Phase 3 (L3) und Phase 1 (L1).
`voltage_l3_n`	Gemessene Leiter-Neutralleiter-Spannung auf Phase 3 (L3).
`voltage_ll_average`	Durchschnittliche Leiter-Leiter-Spannung über alle Phasenpaare.

Zusätzliche Hinweise

NULL- vs. Nullwerte

Es gibt einen wichtigen Unterschied zwischen den Feldern power und active_power_total:

power enthält immer einen numerischen Wert. Fehlende Messungen werden als 0 dargestellt.
active_power_total kann NULL enthalten, wenn keine Messung empfangen wurde, sodass Sie zwischen einem echten Nullwert und einem fehlenden Datenpunkt unterscheiden können.

Stromsensoren vs. Leistungsmessgeräte

Einige Messwerte werden je nach Gerätetyp unterschiedlich berechnet:

Stromsensoren berechnen die Leistung indirekt aus dem gemessenen Strom in Kombination mit der konfigurierten Spannung und dem Leistungsfaktor.
Leistungsmessgeräte messen die Wirkleistung direkt und liefern einen umfangreicheren Satz elektrischer Messungen, einschließlich phasenweiser Spannungen, Ströme und Leistungsfaktor.

Energieberechnung

Das Feld energy wird aus dem Feld power mittels zeitbasierter Integration abgeleitet. Es spiegelt den kumulativen Energieverbrauch über das Messintervall wider.