ЕКГ — формат експорту 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 Zend(Date): кінець знімання у форматіyyyy-MM-dd HH:mm:ss Zclassification(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
- Регулярність: повторні знімання допомагають бачити закономірності, але не замінюють огляд
- Розмір файлу: повні масиви напруги роблять експорт великим
Поради
- Знімайте в однакових умовах для трендів
- Тримайте годинник правильно й не рухайтеся під час запису
- Обмежуйте діапазон дат при експорті через обсяг даних
Пов’язані матеріали
- Огляд формату JSON
- Сповіщення про пульс — високий/низький пульс
- Ручний експорт
- Автоматизації