HealthyApps Help Center

EKG – formát exportu JSON

Štruktúra EKG v JSON exportoch

Last updated: April 5, 2026

Na tejto stránke

EKG (elektrokardiogram)

Údaje EKG zahŕňajú záznamy elektrokardiogramu z kompatibilných zariadení Apple (napr. Apple Watch Series 4 a novšie). EKG poskytuje analýzu srdcového rytmu a môže signalizovať stavy ako fibrilácia predsiení. V JSON exportoch sú údaje EKG v poli ecg.

Štruktúra

Každý záznam EKG obsahuje klasifikáciu, merania srdcovej frekvencie, napätia a informácie o vzorkovaní:

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:30:30 -0800",
  "classification": "Sinus Rhythm",
  "severity": "Not Set",
  "averageHeartRate": 72,
  "numberOfVoltageMeasurements": 512,
  "voltageMeasurements": [
    {
      "date": "2024-02-06 14:30:00.000 -0800",
      "voltage": 0.123,
      "units": "V"
    }
  ],
  "samplingFrequency": 512,
  "source": "Apple Watch"
}

Polia

Povinné polia

  • start (Date): Začiatok merania EKG vo formáte yyyy-MM-dd HH:mm:ss Z
  • end (Date): Koniec merania EKG vo formáte yyyy-MM-dd HH:mm:ss Z
  • classification (String): Klasifikácia rytmu (pozri nižšie)
  • averageHeartRate (Number): Priemerná srdcová frekvencia počas merania (bpm)
  • numberOfVoltageMeasurements (Number): Počet meraní napätia v zázname
  • voltageMeasurements (Array): Pole meraní napätia (pozri časť Merania napätia)
  • samplingFrequency (Number): Vzorkovacia frekvencia v Hz (typicky 512 Hz pre Apple Watch)
  • source (String): Zariadenie alebo aplikácia, ktorá EKG zaznamenala

Voliteľné polia

  • severity (String): Závažnosť výsledku (môže byť „Not Set“, ak neplatí)

Klasifikácie EKG

Pole classification udáva zistený rytmus (hodnoty zodpovedajú výstupu systému):

  • "Sinus Rhythm" — normálny sínusový rytmus
  • "Atrial Fibrillation" — fibrilácia predsiení (AFib)
  • "High Heart Rate" — vysoká srdcová frekvencia
  • "Inconclusive Low Heart Rate" — nejednoznačné pri nízkej frekvencii
  • "Inconclusive High Heart Rate" — nejednoznačné pri vysokej frekvencii
  • "Inconclusive" — klasifikácia nejednoznačná
  • "Inconclusive Poor Recording" — slabý signál
  • "Unrecognized" — nerozpoznaná klasifikácia

Merania napätia

Každý záznam obsahuje pole meraní elektrickej aktivity srdca v čase:

{
  "voltageMeasurements": [
    {
      "date": "2024-02-06 14:30:00.000 -0800",
      "voltage": 0.123,
      "units": "V"
    },
    {
      "date": "2024-02-06 14:30:00.002 -0800",
      "voltage": 0.125,
      "units": "V"
    }
  ]
}

Polia merania napätia:

  • date (Date): Časová značka merania (vrátane milisekúnd)
  • voltage (Number): Napätie vo voltách
  • units (String): Jednotka (typicky "V")

Poznámka: Merania zodpovedajú frekvencii samplingFrequency (typicky 512 Hz, t. j. 512 vzoriek za sekundu).

Príklady záznamov

Normálny sínusový rytmus

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:30:30 -0800",
  "classification": "Sinus Rhythm",
  "severity": "Not Set",
  "averageHeartRate": 72,
  "numberOfVoltageMeasurements": 15360,
  "voltageMeasurements": [
    {
      "date": "2024-02-06 14:30:00.000 -0800",
      "voltage": 0.123,
      "units": "V"
    }
  ],
  "samplingFrequency": 512,
  "source": "Apple Watch"
}

Detekcia fibrilácie predsiení

{
  "start": "2024-02-06 16:45:00 -0800",
  "end": "2024-02-06 16:45:30 -0800",
  "classification": "Atrial Fibrillation",
  "severity": "Not Set",
  "averageHeartRate": 95,
  "numberOfVoltageMeasurements": 15360,
  "voltageMeasurements": [
    {
      "date": "2024-02-06 16:45:00.000 -0800",
      "voltage": 0.145,
      "units": "V"
    }
  ],
  "samplingFrequency": 512,
  "source": "Apple Watch"
}

Nejednoznačné meranie

{
  "start": "2024-02-06 18:00:00 -0800",
  "end": "2024-02-06 18:00:30 -0800",
  "classification": "Inconclusive Poor Recording",
  "severity": "Not Set",
  "averageHeartRate": 68,
  "numberOfVoltageMeasurements": 15360,
  "voltageMeasurements": [
    {
      "date": "2024-02-06 18:00:00.000 -0800",
      "voltage": 0.098,
      "units": "V"
    }
  ],
  "samplingFrequency": 512,
  "source": "Apple Watch"
}

Pochopenie údajov EKG

Vzorkovacia frekvencia

samplingFrequency (typicky 512 Hz) udáva počet meraní napätia za sekundu. Pre 30-sekundové EKG:

  • Celkom meraní = 512 × 30 = 15 360
  • Každé meranie zhruba 0,002 s (2 ms) aktivity

Merania napätia

Napätia popisujú elektrickú aktivitu srdca:

  • Kladné hodnoty: depolarizácia (kontrakcia)
  • Záporné hodnoty: repolarizácia (relaxácia)
  • Analýza priebehu: vzor v čase charakterizuje rytmus

Význam klasifikácie

  • Sinus Rhythm: fyziologický rytmus
  • Atrial Fibrillation: nepravidelný rytmus — môže vyžadovať lekárske vyhodnotenie
  • Inconclusive: slabý signál, pohyb pri meraní alebo iné faktory
  • High/Low Heart Rate: frekvencia mimo rozsahu vhodného pre spoľahlivú klasifikáciu

Kompatibilita zariadení

EKG vyžaduje:

  • Apple Watch Series 4 alebo novší (s aplikáciou EKG)
  • iOS 12.1.1 alebo novší na spárovanom iPhone
  • Nainštalovanú a nastavenú aplikáciu EKG

Prípady použitia

  • Sledovanie rytmu: trendy v čase
  • AFib: epizódy fibrilácie predsiení
  • Zdravotná dokumentácia: zdieľanie so zdravotníkmi
  • Trendy: zmeny rytmu
  • Súvis s príznakmi: prepojenie s príznakmi alebo aktivitou

Dôležité poznámky

  • Nie je zdravotnícka pomôcka: EKG na Apple Watch nenahrádza odbornú diagnózu
  • Konzultujte lekára: najmä pri výsledkoch naznačujúcich AFib
  • Pravidelné merania: môžu pomôcť s trendmi, nenahrádzajú starostlivosť odborníka
  • Veľkosť súborov: export s plnými krivkami napätia môže byť veľký kvôli vysokej vzorkovacej frekvencii

Tipy

  • Konštantné podmienky: merania v podobnom čase pomáhajú trendom
  • Správne uchytenie hodinky a pokoj pri meraní
  • Rozsah dátumov: pri exporte zvážte obdobie; plné krivky výrazne zväčšujú súbor

Súvisiaca dokumentácia