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読み取り中の平均心拍数(1分あたりの拍動数、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、つまり1秒あたり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)は、1秒あたりに取得される電圧測定の数を示します。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データをエクスポートする際は、日付範囲を考慮してください。完全な電圧測定を含むファイルは大きくなる可能性があります

関連ドキュメント