ECG — format eksport JSON

Dokumentasi untuk struktur ECG dalam eksport JSON

Last updated: April 5, 2026

Pada halaman ini

ECG (Elektrokardiogram)

Data ECG merangkumi bacaan elektrokardiogram daripada peranti Apple serasi (seperti Apple Watch Series 4 dan ke atas). Data ECG menyediakan analisis irama jantung terperinci dan boleh mengesan keadaan seperti fibrilasi atrium. Dalam eksport JSON, data ECG disimpan dalam tatasusunan ecg.

Struktur

Setiap entri ECG merangkumi keputusan pengelasan, ukuran kadar denyutan jantung, data voltan dan maklumat pensampelan:

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

Medan

Medan wajib

  • start (Tarikh): Masa mula bacaan ECG dalam format yyyy-MM-dd HH:mm:ss Z
  • end (Tarikh): Masa tamat bacaan ECG dalam format yyyy-MM-dd HH:mm:ss Z
  • classification (Rentetan): Pengelasan irama jantung (lihat pengelasan di bawah)
  • averageHeartRate (Nombor): Purata kadar denyutan jantung semasa bacaan ECG dalam denyutan per minit (bpm)
  • numberOfVoltageMeasurements (Nombor): Jumlah ukuran voltan dalam sampel ECG
  • voltageMeasurements (Tatasusunan): Tatasusunan ukuran voltan (lihat Ukuran voltan di bawah)
  • samplingFrequency (Nombor): Kekerapan pensampelan dalam Hz (biasanya 512 Hz untuk Apple Watch)
  • source (Rentetan): Peranti atau apl yang merekodkan ECG

Medan pilihan

  • severity (Rentetan): Pengelasan keterukan keputusan ECG (mungkin "Not Set" jika tidak terpakai)

Pengelasan ECG

Medan classification menunjukkan irama jantung yang dikesan:

  • "Sinus Rhythm" — Irama jantung normal
  • "Atrial Fibrillation" — Irama tidak teratur (AFib) dikesan
  • "High Heart Rate" — Kadar denyutan jantung melebihi julat normal
  • "Inconclusive Low Heart Rate" — Tidak dapat mengelas kerana kadar denyutan rendah
  • "Inconclusive High Heart Rate" — Tidak dapat mengelas kerana kadar denyutan tinggi
  • "Inconclusive" — Tidak dapat menentukan pengelasan
  • "Inconclusive Poor Recording" — Tidak dapat mengelas kerana kualiti isyarat lemah
  • "Unrecognized" — Pengelasan tidak dikenali

Ukuran voltan

Setiap entri ECG merangkumi tatasusunan ukuran voltan yang mewakili aktiviti elektrik jantung mengikut masa:

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

Medan ukuran voltan:

  • date (Tarikh): Cap masa tepat ukuran voltan (merangkumi milisaat)
  • voltage (Nombor): Nilai voltan dalam volt
  • units (Rentetan): Unit ukuran (biasanya "V" untuk volt)

Nota: Ukuran voltan disampel pada kekerapan yang ditetapkan oleh samplingFrequency (biasanya 512 Hz, iaitu 512 ukuran sesaat).

Contoh entri

Irama sinus normal

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

Pengesanan fibrilasi atrium

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

Bacaan tidak menyimpulkan

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

Memahami data ECG

Kekerapan pensampelan

samplingFrequency (biasanya 512 Hz) menunjukkan berapa banyak ukuran voltan diambil sesaat. Untuk bacaan ECG 30 saat:

  • Jumlah ukuran = 512 × 30 = 15,360 ukuran
  • Setiap ukuran mewakili kira-kira 0.002 saat (2 milisaat) aktiviti jantung

Ukuran voltan

Ukuran voltan mewakili aktiviti elektrik jantung:

  • Nilai positif: Depolarisasi (pengecutan otot jantung)
  • Nilai negatif: Repolarisasi (relaksasi otot jantung)
  • Analisis corak: Corak perubahan voltan mengikut masa menunjukkan irama jantung

Tafsiran pengelasan

  • Sinus Rhythm: Irama jantung normal dan sihat
  • Atrial Fibrillation: Irama tidak teratur yang mungkin memerlukan perhatian perubatan
  • Inconclusive: Mungkin menunjukkan kualiti isyarat lemah, pergerakan semasa bacaan atau faktor lain
  • High/Low Heart Rate: Kadar denyutan jantung di luar julat normal untuk pengelasan tepat

Keserasian peranti

Fungsi ECG memerlukan:

  • Apple Watch Series 4 atau ke atas (dengan apl ECG)
  • iOS 12.1.1 atau ke atas pada iPhone berpasangan
  • Apl ECG dipasang dan disediakan

Kes penggunaan

Data ECG berguna untuk:

  • Pemantauan irama jantung: Jejak corak irama jantung mengikut masa
  • Pengesanan AFib: Pantau episod fibrilasi atrium
  • Rekod perubatan: Kongsi data ECG dengan penyedia penjagaan kesihatan
  • Analisis trend: Kenal pasti corak atau perubahan dalam irama jantung
  • Korelasi gejala: Rujuk silang bacaan ECG dengan gejala atau aktiviti

Nota penting

  • Bukan peranti perubatan: ECG Apple Watch tidak bertujuan menggantikan diagnosis perubatan profesional
  • Rujuk penyedia penjagaan: Sentiasa berbincang dengan profesional kesihatan tentang keputusan ECG, terutamanya jika AFib dikesan
  • Pemantauan berkala: Bacaan ECG berkala boleh membantu mengenal pasti corak, tetapi tidak patut menggantikan penjagaan perubatan profesional
  • Saiz fail: Eksport ECG dengan ukuran voltan penuh boleh besar kerana kadar pensampelan tinggi

Petua

  • Bacaan konsisten: Ambil bacaan ECG pada masa konsisten untuk analisis trend lebih baik
  • Kedudukan betul: Pastikan pemakaian jam dan kepegunan semasa bacaan untuk keputusan tepat
  • Eksport terpilih: Pertimbangkan julat tarikh semasa mengeksport data ECG, kerana fail boleh besar dengan ukuran voltan penuh

Dokumentasi berkaitan