ЕКГ — формат експорту JSON

Структура даних ЕКГ у JSON-експорті

Last updated: April 5, 2026

На цій сторінці

ЕКГ (електрокардіограма)

Дані ЕКГ містять записи з сумісних пристроїв Apple (наприклад, Apple Watch Series 4 і новіших). Вони дають детальний аналіз ритму й можуть виявляти стани на кшталт фібриляції передсердь. У JSON-експорті ЕКГ зберігаються в масиві ecg.

Структура

Кожен запис містить класифікацію, середній пульс, виміри напруги та параметри дискретизації:

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

Поля

Обов’язкові поля

  • start (Date): початок знімання у форматі yyyy-MM-dd HH:mm:ss Z
  • end (Date): кінець знімання у форматі yyyy-MM-dd HH:mm:ss Z
  • classification (String): класифікація ритму (див. нижче)
  • averageHeartRate (Number): середній пульс під час запису (уд/хв)
  • numberOfVoltageMeasurements (Number): загальна кількість вимірів напруги
  • voltageMeasurements (Array): масив вимірів напруги
  • samplingFrequency (Number): частота дискретизації в Гц (зазвичай 512 Гц для Apple Watch)
  • source (String): пристрій або застосунок, що зробив запис

Необов’язкові поля

  • severity (String): тяжкість/категорія результату (може бути "Not Set", якщо не застосовується)

Класифікації ЕКГ

Поле classification відображає виявлений ритм:

  • "Sinus Rhythm" — синусовий ритм (норма)
  • "Atrial Fibrillation" — фібриляція передсердь
  • "High Heart Rate" — підвищений пульс
  • "Inconclusive Low Heart Rate" — неможливо класифікувати через низький пульс
  • "Inconclusive High Heart Rate" — неможливо класифікувати через високий пульс
  • "Inconclusive" — класифікація невизначена
  • "Inconclusive Poor Recording" — погана якість сигналу
  • "Unrecognized" — нерозпізнана класифікація

Виміри напруги

Кожен запис містить масив вимірів електричної активності серця:

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

Поля виміру напруги:

  • date (Date): позначка часу з мілісекундами
  • voltage (Number): значення у вольтах
  • units (String): одиниці (зазвичай "V")

Примітка: Виміри йдуть з частотою samplingFrequency (зазвичай 512 Гц — 512 вимірів на секунду).

Приклади записів

Синусовий ритм

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

Виявлення фібриляції передсердь

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

Невизначений результат

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

Розуміння даних ЕКГ

Частота дискретизації

samplingFrequency (зазвичай 512 Гц) — скільки вимірів на секунду. Для запису 30 с:

  • усього вимірів ≈ 512 × 30 = 15 360
  • крок між вимірами ≈ 0,002 с (2 мс)

Виміри напруги

Відображають електричну активність серця:

  • додатні значення — деполяризація
  • від’ємні — реполяризація
  • форма кривої в часі відповідає ритму

Інтерпретація класифікації

  • Sinus Rhythm: нормальний ритм
  • Atrial Fibrillation: нерегулярний ритм — потрібна консультація лікаря
  • Inconclusive: поганий сигнал, рух під час знімання тощо
  • High/Low Heart Rate: пульс поза діапазоном для надійної класифікації

Сумісність пристроїв

ЕКГ на Apple Watch потребує:

  • Apple Watch Series 4 або новіших (з застосунком ЕКГ)
  • iOS 12.1.1 або новіших на парному iPhone
  • налаштованого застосунку ЕКГ

Сценарії використання

  • Моніторинг ритму в часі
  • Відстеження епізодів фібриляції
  • Передача записів лікарю
  • Аналіз тенденцій
  • Зв’язок із симптомами та активністю

Важливі зауваження

  • Не медичний пристрій: ЕКГ Apple Watch не замінює діагностику лікаря
  • Консультація: звертайтеся до фахівців щодо результатів, особливо при AFib
  • Регулярність: повторні знімання допомагають бачити закономірності, але не замінюють огляд
  • Розмір файлу: повні масиви напруги роблять експорт великим

Поради

  • Знімайте в однакових умовах для трендів
  • Тримайте годинник правильно й не рухайтеся під час запису
  • Обмежуйте діапазон дат при експорті через обсяг даних

Пов’язані матеріали