EKG – JSON format izvoza

Dokumentacija strukture EKG podataka u JSON izvozima

Last updated: February 6, 2026

Na ovoj stranici

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 formatu yyyy-MM-dd HH:mm:ss Z
  • end (Date): Kraj EKG snimanja u formatu yyyy-MM-dd HH:mm:ss Z
  • classification (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 uzorku
  • voltageMeasurements (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 voltima
  • units (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