Data-export & API (nl)

Overzicht

Dit referentie-artikel beschrijft alle meetwaarden die beschikbaar zijn via de data-export (CSV) en API. De meetwaarden zijn onderverdeeld in twee categorieën:

Universele meetwaarden — worden teruggegeven voor alle elektrische apparaten, inclusief stroomsensoren en vermogensmeters.
Vermogensmeter-meetwaarden — worden uitsluitend teruggegeven voor vermogensmeterapparaten en bieden uitgebreide elektrische metingen.

Tip: Als een kolom in uw export verschijnt maar NULL-waarden toont, controleer dan of uw apparaat een vermogensmeter is en of het betreffende meettype wordt ondersteund door uw hardwareconfiguratie.

Universele meetwaarden

De volgende meetwaarden worden teruggegeven voor alle elektrische apparaten, zowel in CSV-exports als in API-antwoorden.

Kolomnaam	Beschrijving
`external_id`	Een unieke identificator die is toegewezen aan de geselecteerde asset. Wordt gebruikt om het apparaat te refereren in externe systemen en integraties.
`asset_name`	De naam van de asset zoals geconfigureerd in het platform.
`Customer`	De naam van de klantlocatie waartoe de asset behoort.
`time_zone`	De tijdzone waarin de asset zich bevindt. Zie hier voor een volledige lijst van ondersteunde tijdzone-identificatoren en hun beschrijvingen.
`measured_at`	De tijdstempel van de meting in lokale tijd (op basis van de geconfigureerde tijdzone van de asset).
`utc_time`	De tijdstempel van de meting in Gecoördineerde Wereldtijd (UTC).
`power`	Gemeten actief vermogen. Dit veld bevat altijd een waarde — als er geen meting is ontvangen van het apparaat, wordt de waarde standaard op 0 gezet. Voor stroomsensoren is dit een berekende waarde afgeleid van de gemeten stroom, de geconfigureerde vermogensfactor en de geconfigureerde spanning. Voor vermogensmeters wordt deze waarde rechtstreeks door het apparaat gemeten.
`energy`	Berekende energie. Rechtstreeks afgeleid van de gemeten of berekende vermogenswaarde over tijd.

Vermogensmeter-meetwaarden

De volgende meetwaarden worden alleen teruggegeven voor vermogensmeterapparaten. Ze verschijnen niet in exports van stroomsensoren. Sommige velden kunnen NULL-waarden bevatten als een specifiek meettype niet wordt ondersteund door de aangesloten hardware.

Kolomnaam	Beschrijving
`active_power_total`	Gemeten actief vermogen. Equivalent aan het power-veld, behalve dat het ontbrekende waarden (NULLs) toont wanneer er geen meting is ontvangen van het apparaat.
`apparent_power_total`	Gemeten schijnbaar vermogen. Vertegenwoordigt het totale vermogen dat door het circuit stroomt, inclusief zowel actieve als reactieve componenten.
`reactive_power_total`	Gemeten reactief vermogen. Vertegenwoordigt het deel van het vermogen dat geen nuttig werk verricht.
`current_l1`	Gemeten stroom op fase 1 (L1).
`current_l2`	Gemeten stroom op fase 2 (L2).
`current_l3`	Gemeten stroom op fase 3 (L3).
`current_n`	Gemeten nulgeleiderstroom.
`current_total`	De equivalente driefasige lijnstroom. Berekend als: apparent_power_total ÷ (√3 × voltage_ll_average).
`power_factor_total`	Gemeten vermogensfactor (bereik -1 tot 1). Vertegenwoordigt de verhouding van actief vermogen tot schijnbaar vermogen. Een waarde van 1 of -1 duidt op een puur resistieve belasting; waarden dichter bij 0 duiden op een kleiner aandeel reactief vermogen.
`voltage_average`	Gemiddelde lijn-naar-nul-spanning over alle fasen.
`voltage_l1_l2`	Gemeten lijn-naar-lijn-spanning tussen fase 1 (L1) en fase 2 (L2).
`voltage_l1_n`	Gemeten lijn-naar-nul-spanning op fase 1 (L1).
`voltage_l2_l3`	Gemeten lijn-naar-lijn-spanning tussen fase 2 (L2) en fase 3 (L3).
`voltage_l2_n`	Gemeten lijn-naar-nul-spanning op fase 2 (L2).
`voltage_l3_l1`	Gemeten lijn-naar-lijn-spanning tussen fase 3 (L3) en fase 1 (L1).
`voltage_l3_n`	Gemeten lijn-naar-nul-spanning op fase 3 (L3).
`voltage_ll_average`	Gemiddelde lijn-naar-lijn-spanning over alle faseparen.

Aanvullende opmerkingen

NULL vs. nulwaarden

Er is een belangrijk onderscheid tussen de velden power en active_power_total:

power bevat altijd een numerieke waarde. Ontbrekende metingen worden weergegeven als 0.
active_power_total kan NULL bevatten als er geen meting is ontvangen, zodat u onderscheid kunt maken tussen een echte nulmeting en een ontbrekend datapunt.

Stroomsensoren vs. vermogensmeters

Sommige meetwaarden worden anders berekend afhankelijk van het apparaattype:

Stroomsensoren berekenen het vermogen indirect aan de hand van de gemeten stroom in combinatie met de geconfigureerde spanning en vermogensfactor.
Vermogensmeters meten het actieve vermogen rechtstreeks en bieden een rijkere set elektrische metingen, inclusief per-fase spanningen, stromen en vermogensfactor.

Energieberekening

Het energy-veld wordt afgeleid van het power-veld via tijdsgebaseerde integratie. Het weerspiegelt het cumulatieve energieverbruik over het meetinterval.