EKG - formát exportu JSON

Dokumentace struktury EKG v JSON exportech.

Last updated: March 31, 2026

Na této stránce

EKG (elektrokardiogram)

Data EKG zahrnují záznamy z kompatibilních zařízení Apple (např. Apple Watch Series 4 a novější). Umožňují podrobnou analýzu rytmu a odhalení stavů jako fibrilace síní. Ve výstupu JSON jsou v poli ecg.

Struktura

Každý záznam obsahuje klasifikaci rytmu, tep, napětové vzorky a informace o vzorkování:

{
  "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"
}

Pole

Povinná pole

  • start (Date): Začátek měření ve formátu yyyy-MM-dd HH:mm:ss Z
  • end (Date): Konec měření ve formátu yyyy-MM-dd HH:mm:ss Z
  • classification (String): Klasifikace srdečního rytmu (viz níže)
  • averageHeartRate (Number): Průměrný tep během měření (bpm)
  • numberOfVoltageMeasurements (Number): Počet napěťových vzorků v záznamu
  • voltageMeasurements (Array): Pole napěťových měření (viz Měření napětí)
  • samplingFrequency (Number): Vzorkovací frekvence v Hz (u Apple Watch typicky 512 Hz)
  • source (String): Zařízení nebo aplikace, která EKG zaznamenala

Volitelná pole

  • severity (String): Závažnost podle výsledku (může být „Not Set“, pokud neplatí)

Klasifikace EKG

Hodnota classification popisuje zjištěný rytmus:

  • "Sinus Rhythm" – fyziologický sinusový rytmus
  • "Atrial Fibrillation" – fibrilace síní (AFib)
  • "High Heart Rate" – tep nad rozsahem pro spolehlivou klasifikaci
  • "Inconclusive Low Heart Rate" – nelze zařadit kvůli nízkému tepu
  • "Inconclusive High Heart Rate" – nelze zařadit kvůli vysokému tepu
  • "Inconclusive" – klasifikaci nelze určit
  • "Inconclusive Poor Recording" – špatná kvalita signálu
  • "Unrecognized" – nerozpoznaná klasifikace

Měření napětí

Každý záznam obsahuje pole napěťových vzorků 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"
    }
  ]
}

Pole měření napětí:

  • date (Date): Přesné časové razítko (včetně milisekund)
  • voltage (Number): Napětí ve voltech
  • units (String): Jednotka (typicky "V")

Poznámka: Vzorkování odpovídá samplingFrequency (typicky 512 Hz = 512 vzorků za sekundu).

Příklady záznamů

Fyziologický sinusový 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"
}

Detekce fibrilace síní

{
  "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é měření

{
  "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"
}

Jak číst data EKG

Vzorkovací frekvence

samplingFrequency (typicky 512 Hz) udává počet vzorků napětí za sekundu. U 30sekundového měření:

  • Celkem vzorků = 512 × 30 = 15 360
  • Každý vzorek odpovídá přibližně 0,002 s (2 ms) aktivity

Napěťové vzorky

Popisují elektrickou aktivitu srdce:

  • kladné hodnoty: depolarizace (stažení srdečního svalu)
  • záporné hodnoty: repolarizace (uvolnění)
  • analýza průběhu: tvar křivky v čase vystihuje rytmus

Význam klasifikací

  • Sinus Rhythm: běžný fyziologický rytmus
  • Atrial Fibrillation: nepravidelný rytmus – může vyžadovat lékařské vyhodnocení
  • Inconclusive: např. špatný signál, pohyb během měření
  • High/Low Heart Rate: tep mimo rozsah spolehlivé klasifikace

Kompatibilita zařízení

Funkce EKG vyžaduje:

  • Apple Watch Series 4 nebo novější s aplikací EKG
  • iOS 12.1.1 nebo novější na spárovaném iPhonu
  • nainstalovanou a nastavenou aplikaci EKG

Typické využití

Data EKG mohou sloužit k:

  • sledování rytmu v čase
  • monitorování epizod AFib
  • sdílení záznamů se zdravotní péčí (podle jejích pokynů)
  • analýze trendů v rytmu
  • propojení s příznaky nebo aktivitami

Důležité upozornění

  • Není náhradou vyšetření: EKG na Apple Watch nenahrazuje diagnostiku ve zdravotnickém zařízení.
  • Konzultujte lékaře: výsledky včetně podezření na AFib vždy řešte s odborníkem.
  • Domácí měření: pravidelné domácí záznamy mohou pomoci sledovat trendy, ale nenahrazují péči odborníka.
  • Velikost souborů: exporty s plnými napěťovými vzorky mohou být velké kvůli vysoké vzorkovací frekvenci.

Tipy

  • Konstantní podmínky: měřte pokud možno za obdobných okolností pro lepší srovnání trendů.
  • Nasazení hodinek: správné utažení a klid během měření zvyšují kvalitu signálu.
  • Rozsah exportu: u plných vzorků zvažte kratší období kvůli velikosti souboru.

Související dokumentace