EKG - formát exportu JSON
Dokumentace struktury EKG v JSON exportech.
Last updated: March 31, 2026
Na této stránce
- Struktura
- Pole
- Povinná pole
- Volitelná pole
- Klasifikace EKG
- Měření napětí
- Příklady záznamů
- Fyziologický sinusový rytmus
- Detekce fibrilace síní
- Nejednoznačné měření
- Jak číst data EKG
- Vzorkovací frekvence
- Napěťové vzorky
- Význam klasifikací
- Kompatibilita zařízení
- Typické využití
- Důležité upozornění
- Tipy
- Související dokumentace
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átuyyyy-MM-dd HH:mm:ss Zend(Date): Konec měření ve formátuyyyy-MM-dd HH:mm:ss Zclassification(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áznamuvoltageMeasurements(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 voltechunits(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
- Přehled formátu exportu JSON
- Oznámení o srdeční frekvenci – upozornění na vysoký/nízký tep
- Průvodce ručním exportem
- Přehled automatizací