ECG - JSON 내보내기 형식
JSON 내보내기에서 ECG 구조에 대한 문서
Last updated: February 6, 2026
On this page
ECG (심전도)
ECG 데이터에는 호환 가능한 Apple 기기(Apple Watch Series 4 이상 등)의 심전도 판독값이 포함됩니다. ECG 데이터는 상세한 심박 리듬 분석을 제공하며 심방세동과 같은 상태를 감지할 수 있습니다. JSON 내보내기에서 ECG 데이터는 ecg 배열에 저장됩니다.
구조
각 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(날짜): ECG 판독의 시작 시간 (형식:yyyy-MM-dd HH:mm:ss Z)end(날짜): ECG 판독의 종료 시간 (형식:yyyy-MM-dd HH:mm:ss Z)classification(문자열): 심박 리듬 분류 (아래 분류 참조)averageHeartRate(숫자): ECG 판독 중 평균 심박수 (분당 박동수, bpm)numberOfVoltageMeasurements(숫자): ECG 샘플의 총 전압 측정 수voltageMeasurements(배열): 전압 측정 배열 (아래 전압 측정 참조)samplingFrequency(숫자): 샘플링 주파수 (Hz) (일반적으로 Apple Watch의 경우 512 Hz)source(문자열): ECG를 기록한 소스 기기 또는 앱
선택적 필드
severity(문자열): ECG 결과의 심각도 분류 (해당하지 않는 경우 "Not Set"일 수 있음)
ECG 분류
classification 필드는 감지된 심박 리듬을 나타냅니다:
"Sinus Rhythm"- 정상 심박 리듬"Atrial Fibrillation"- 불규칙한 심박 리듬 (AFib) 감지됨"High Heart Rate"- 정상 범위를 초과하는 심박수"Inconclusive Low Heart Rate"- 낮은 심박수로 인해 분류할 수 없음"Inconclusive High Heart Rate"- 높은 심박수로 인해 분류할 수 없음"Inconclusive"- 분류를 결정할 수 없음"Inconclusive Poor Recording"- 낮은 신호 품질로 인해 분류할 수 없음"Unrecognized"- 분류가 인식되지 않음
전압 측정
각 ECG 항목에는 시간에 따른 심장의 전기 활동을 나타내는 전압 측정 배열이 포함됩니다:
{
"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(날짜): 전압 측정의 정확한 타임스탬프 (밀리초 포함)voltage(숫자): 볼트 단위의 전압 값units(문자열): 측정 단위 (일반적으로 볼트의 경우"V")
참고: 전압 측정은 samplingFrequency로 지정된 주파수 (일반적으로 512 Hz, 즉 초당 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"
}
ECG 데이터 이해
샘플링 주파수
samplingFrequency (일반적으로 512 Hz)는 초당 수행되는 전압 측정 수를 나타냅니다. 30초 ECG 판독의 경우:
- 총 측정 수 = 512 × 30 = 15,360회 측정
- 각 측정은 약 0.002초 (2밀리초)의 심장 활동을 나타냅니다
전압 측정
전압 측정은 심장의 전기 활동을 나타냅니다:
- 양수 값: 탈분극 (심근 수축)
- 음수 값: 재분극 (심근 이완)
- 패턴 분석: 시간에 따른 전압 변화의 패턴이 심박 리듬을 나타냅니다
분류 해석
- 동리듬: 정상적이고 건강한 심박 리듬
- 심방세동: 의학적 관심이 필요할 수 있는 불규칙한 리듬
- 결론을 내릴 수 없음: 낮은 신호 품질, 판독 중 움직임 또는 기타 요인을 나타낼 수 있음
- 높은/낮은 심박수: 정확한 분류를 위한 정상 범위를 벗어난 심박수
기기 호환성
ECG 기능에는 다음이 필요합니다:
- Apple Watch Series 4 이상 (ECG 앱 포함)
- 페어링된 iPhone에서 iOS 12.1.1 이상
- ECG 앱 설치 및 설정됨
사용 사례
ECG 데이터는 다음 용도로 유용합니다:
- 심박 리듬 모니터링: 시간에 따른 심박 리듬 패턴 추적
- AFib 감지: 심방세동 에피소드 모니터링
- 의료 기록: 의료 제공자와 ECG 데이터 공유
- 추세 분석: 심박 리듬의 패턴 또는 변화 식별
- 증상 상관관계: ECG 판독을 증상이나 활동과 교차 참조
중요한 참고사항
- 의료 기기가 아닙니다: Apple Watch ECG는 전문 의료 진단을 대체하기 위한 것이 아닙니다
- 의료 제공자와 상담: ECG 결과에 대해, 특히 AFib가 감지된 경우 항상 의료 전문가와 상담하세요
- 정기적인 모니터링: 정기적인 ECG 판독은 패턴 식별에 도움이 될 수 있지만 전문 의료 서비스를 대체해서는 안 됩니다
- 파일 크기: 전체 전압 측정이 포함된 ECG 내보내기는 높은 샘플링 속도로 인해 클 수 있습니다
팁
- 일관된 판독: 더 나은 추세 분석을 위해 일관된 시간에 ECG 판독을 수행합니다
- 적절한 배치: 정확한 결과를 위해 판독 중 적절한 시계 배치와 정지 상태를 보장합니다
- 선택적으로 내보내기: ECG 데이터를 내보낼 때 날짜 범위를 고려하세요. 전체 전압 측정이 포함된 파일은 클 수 있습니다
관련 문서
- JSON 내보내기 형식 개요
- 심박수 알림 - 높은/낮은 심박수 경고용
- 수동 내보내기 가이드
- 자동화 개요