EKG – JSON format izvoza
Dokumentacija strukture EKG podataka u JSON izvozima
Last updated: February 6, 2026
Na ovoj stranici
- Struktura
- Polja
- Obavezna polja
- Opcijska polja
- EKG klasifikacije
- Mjerenja napona
- Primjeri unosa
- Normalni sinusni ritam
- Otkrivanje fibrilacije atrija
- Neodređeno snimanje
- Razumijevanje EKG podataka
- Frekvencija uzorkovanja
- Mjerenja napona
- Tumačenje klasifikacije
- Kompatibilnost uređaja
- Primjene
- Važne napomene
- Savjeti
- Povezana dokumentacija
EKG (elektrokardiogram)
EKG podaci obuhvaćaju elektrokardiogramska snimanja s kompatibilnih Apple uređaja (primjerice Apple Watch Series 4 i noviji). EKG podaci daju detaljnu analizu ritma srca i mogu otkriti stanja poput fibrilacije atrija. U JSON izvozima EKG podaci se pohranjuju u nizu ecg.
Struktura
Svaki EKG unos uključuje rezultate klasifikacije, mjerenja otkucaja srca, podatke o naponu i informacije o uzorkovanju:
{
"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"
}
Polja
Obavezna polja
start(Date): Početak EKG snimanja u formatuyyyy-MM-dd HH:mm:ss Zend(Date): Kraj EKG snimanja u formatuyyyy-MM-dd HH:mm:ss Zclassification(String): Klasifikacija ritma srca (vidi klasifikacije u nastavku)averageHeartRate(Number): Prosječni broj otkucaja tijekom EKG snimanja u otkucajima u minuti (bpm)numberOfVoltageMeasurements(Number): Ukupan broj mjerenja napona u EKG uzorkuvoltageMeasurements(Array): Niz mjerenja napona (vidi Mjerenja napona)samplingFrequency(Number): Frekvencija uzorkovanja u Hz (obično 512 Hz za Apple Watch)source(String): Izvorni uređaj ili aplikacija koja je snimila EKG
Opcijska polja
severity(String): Klasifikacija težine rezultata EKG (može biti „Not Set” ako nije primjenjivo)
EKG klasifikacije
Polje classification pokazuje otkriveni ritam srca:
"Sinus Rhythm"— normalan ritam srca"Atrial Fibrillation"— nepravilan ritam (otkrivena AFib)"High Heart Rate"— otkucaji iznad uobičajenog raspona"Inconclusive Low Heart Rate"— nije moguće klasificirati zbog niskih otkucaja"Inconclusive High Heart Rate"— nije moguće klasificirati zbog visokih otkucaja"Inconclusive"— nije moguće odrediti klasifikaciju"Inconclusive Poor Recording"— nije moguće klasificirati zbog loše kvalitete signala"Unrecognized"— klasifikacija nije prepoznata
Mjerenja napona
Svaki EKG unos uključuje niz mjerenja napona koji predstavljaju električnu aktivnost srca tijekom vremena:
{
"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"
}
]
}
Polja mjerenja napona:
date(Date): Točna vremenska oznaka mjerenja napona (uključuje milisekunde)voltage(Number): Vrijednost napona u voltimaunits(String): Mjerna jedinica (obično"V"za volt)
Napomena: Mjerenja napona uzorkuju se frekvencijom zadanom u samplingFrequency (obično 512 Hz, tj. 512 mjerenja u sekundi).
Primjeri unosa
Normalni sinusni ritam
{
"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"
}
Otkrivanje fibrilacije atrija
{
"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"
}
Neodređeno snimanje
{
"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"
}
Razumijevanje EKG podataka
Frekvencija uzorkovanja
samplingFrequency (obično 512 Hz) pokazuje koliko se mjerenja napona snimi u sekundi. Za 30-sekundno EKG snimanje:
- Ukupno mjerenja = 512 × 30 = 15 360 mjerenja
- Svako mjerenje predstavlja otprilike 0,002 sekunde (2 milisekunde) aktivnosti srca
Mjerenja napona
Mjerenja napona predstavljaju električnu aktivnost srca:
- Pozitivne vrijednosti: depolarizacija (kontrakcija mišića srca)
- Negativne vrijednosti: repolarizacija (relaksacija mišića srca)
- Analiza obrasca: obrazac promjena napona tijekom vremena ukazuje na ritam srca
Tumačenje klasifikacije
- Sinus Rhythm: normalan, zdrav ritam srca
- Atrial Fibrillation: nepravilan ritam koji može zahtijevati medicinsku pažnju
- Inconclusive: može ukazivati na lošu kvalitetu signala, pokret tijekom snimanja ili druge faktore
- High/Low Heart Rate: otkucaji izvan raspona za točnu klasifikaciju
Kompatibilnost uređaja
EKG funkcionalnost zahtijeva:
- Apple Watch Series 4 ili noviji (s EKG aplikacijom)
- iOS 12.1.1 ili noviji na uparenom iPhoneu
- EKG aplikaciju instaliranu i postavljenu
Primjene
EKG podaci mogu biti korisni za:
- Praćenje ritma srca: praćenje obrazaca ritma tijekom vremena
- Otkrivanje AFib-a: nadzor epizoda fibrilacije atrija
- Medicinsku dokumentaciju: dijeljenje EKG podataka s pružateljima skrbi
- Analizu trendova: prepoznavanje obrazaca ili promjena u ritmu
- Povezanost sa simptomima: usporedba EKG snimanja sa simptomima ili aktivnostima
Važne napomene
- Nije medicinski uređaj: EKG na Apple Watchu nije namijenjen zamjeni profesionalne dijagnoze
- Konzultirajte liječnike: uvijek se posavjetujte s medicinskim stručnjacima o rezultatima EKG-a, posebno ako je otkrivena AFib
- Redovito praćenje: redovita EKG snimanja mogu pomoći u prepoznavanju obrazaca, ali ne zamjenjuju profesionalnu skrb
- Veličina datoteke: EKG izvozi s punim mjerenjima napona mogu biti veliki zbog visoke frekvencije uzorkovanja
Savjeti
- Dosljedna snimanja: snimajte EKG u dosljednim vremenima radi bolje analize trendova
- Ispravan položaj: osigurajte dobar položaj sata i mir tijekom snimanja radi točnih rezultata
- Selektivan izvoz: razmotrite raspon datuma pri izvozu EKG podataka jer datoteke s punim mjerenjima mogu biti velike
Povezana dokumentacija
- Pregled JSON formata izvoza
- Obavijesti o otkucajima srca — za upozorenja visokih/niskih otkucaja
- Vodič za ručni izvoz
- Pregled automatizacija