心拍数通知 - JSONエクスポート形式

JSONエクスポートでの心拍数通知の構造に関するドキュメント

Last updated: February 6, 2026

On this page

心拍数通知

心拍数通知には、Apple Watchからの高心拍数および低心拍数のアラート、不規則なリズム通知、これらのイベント中に収集された詳細な心拍数データが含まれます。JSONエクスポートでは、心拍数通知はheartRateNotifications配列に保存されます。

構造

心拍数通知データは、他の健康指標とは異なる独自の構造を持っています。各通知には、イベントのタイミング、しきい値（高/低通知用）、およびイベント中の詳細な心拍数測定値が含まれます：

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:35:00 -0800",
  "threshold": 100,
  "heartRate": [
    {
      "hr": 105,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": [
    {
      "hrv": 45,
      "units": "ms",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ]
}

フィールド

必須フィールド

start (日付): 心拍数通知イベントの開始時刻（形式：yyyy-MM-dd HH:mm:ss Z）
end (日付): 心拍数通知イベントの終了時刻（形式：yyyy-MM-dd HH:mm:ss Z）
heartRate (配列): イベント中の心拍数測定値の配列（以下の心拍数データを参照）
heartRateVariation (配列): イベント中の心拍変動（HRV）測定値の配列（以下のHRVデータを参照）

オプションフィールド

threshold (数値): 通知をトリガーした心拍数のしきい値。高心拍数および低心拍数通知にのみ含まれます。

通知タイプ

高心拍数通知

安静時に心拍数が設定されたしきい値（通常100-150 bpm）を超えたときにトリガーされます。

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:35:00 -0800",
  "threshold": 100,
  "heartRate": [
    {
      "hr": 105,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": []
}

低心拍数通知

安静時に心拍数が設定されたしきい値（通常40-50 bpm）を下回ったときにトリガーされます。

{
  "start": "2024-02-06 03:00:00 -0800",
  "end": "2024-02-06 03:05:00 -0800",
  "threshold": 40,
  "heartRate": [
    {
      "hr": 38,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 03:00:00 -0800",
        "end": "2024-02-06 03:00:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": []
}

不規則なリズム通知

Apple Watchが心房細動を示す可能性のある不規則な心拍リズムを検出したときにトリガーされます。

{
  "start": "2024-02-06 16:00:00 -0800",
  "end": "2024-02-06 16:05:00 -0800",
  "heartRate": [
    {
      "hr": 85,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 16:00:00 -0800",
        "end": "2024-02-06 16:00:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": [
    {
      "hrv": 35,
      "units": "ms",
      "timestamp": {
        "start": "2024-02-06 16:00:00 -0800",
        "end": "2024-02-06 16:00:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ]
}

注: 不規則なリズム通知にはthresholdフィールドは含まれません。

心拍数データ

heartRate配列には、通知イベント中の詳細な心拍数測定値が含まれます：

{
  "hr": 105,
  "units": "bpm",
  "timestamp": {
    "start": "2024-02-06 14:30:00 -0800",
    "end": "2024-02-06 14:30:05 -0800",
    "interval": {
      "duration": 5,
      "units": "s"
    }
  }
}

フィールド:

hr (数値): 1分あたりの拍数で表した心拍数値
units (文字列): 測定単位（1分あたりの拍数は常に"bpm"）
timestamp (オブジェクト): この測定値の時間期間
- start (日付): 測定期間の開始
- end (日付): 測定期間の終了
- interval (オブジェクト): 測定の継続時間
  - duration (数値): 継続時間の値
  - units (文字列): 単位（秒は常に"s"）

心拍変動（HRV）データ

heartRateVariation配列には心拍変動の測定値が含まれます：

{
  "hrv": 45,
  "units": "ms",
  "timestamp": {
    "start": "2024-02-06 14:30:00 -0800",
    "end": "2024-02-06 14:30:05 -0800",
    "interval": {
      "duration": 5,
      "units": "s"
    }
  }
}

フィールド:

hrv (数値): ミリ秒で表した心拍変動値
units (文字列): 測定単位（ミリ秒は常に"ms"）
timestamp (オブジェクト): 心拍数のタイムスタンプと同じ構造

HRVの理解:

HRVは心拍間の時間の変動を測定します
より高いHRVは、一般的に心血管フィットネスとストレス回復が良好であることを示します
より低いHRVは、ストレス、疲労、または健康問題を示す可能性があります
HRVは、時刻、活動レベル、個人要因に基づいて大きく変動する可能性があります

例：完全な通知エントリ

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:35:00 -0800",
  "threshold": 100,
  "heartRate": [
    {
      "hr": 105,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    },
    {
      "hr": 108,
      "units": "bpm",
      "timestamp": {
        "start": "2024-02-06 14:30:05 -0800",
        "end": "2024-02-06 14:30:10 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ],
  "heartRateVariation": [
    {
      "hrv": 45,
      "units": "ms",
      "timestamp": {
        "start": "2024-02-06 14:30:00 -0800",
        "end": "2024-02-06 14:30:05 -0800",
        "interval": {
          "duration": 5,
          "units": "s"
        }
      }
    }
  ]
}

通知しきい値

しきい値はApple Health設定でユーザーが設定可能です：

高心拍数: 通常100-150 bpm（デフォルトは年齢によって異なります）
低心拍数: 通常40-50 bpm（デフォルトは年齢によって異なります）

thresholdフィールドは、通知をトリガーした正確なしきい値を示します。

デバイス要件

心拍数通知には以下が必要です：

Apple Watch Series 1以降（基本的な心拍数モニタリング用）
Apple Watch Series 4以降（不規則なリズム通知用）
WatchOS 5.1.2以降（不規則なリズム通知用）
Apple Health設定で通知が有効

使用例

心拍数通知データは次の用途に役立ちます：

健康モニタリング: 心拍数が正常範囲を超えたときの追跡
AFib検出: 潜在的な心房細動のための不規則なリズム通知の監視
医療記録: 医療提供者との通知イベントの共有
パターン分析: 心拍数イベントのトリガーまたはパターンの識別
フィットネスインサイト: HRVデータを通じた回復とストレス反応の理解
症状相関: 通知を症状、活動、または薬物と相互参照

重要な注意事項

医療機器ではありません: Apple Watch通知は専門的な医療診断に代わるものではありません
医療提供者に相談: 心拍数通知、特に不規則なリズムアラートについては、常に医療専門家に相談してください
文脈が重要: 心拍数は運動、ストレス、カフェイン、薬物、またはその他の要因により上昇する可能性があります
AFib通知: 不規則なリズム通知は心房細動を示す可能性があり、医療提供者と話し合う必要があります

ヒント

通知を確認: パターンを識別するために心拍数通知を定期的に確認してください
文脈を記録: 通知が発生したときに何をしていたかを考慮してください（運動、ストレス、睡眠など）
傾向を追跡: 時間の経過とともに通知の頻度とパターンを監視してください
ECGと組み合わせる: 包括的な心臓健康モニタリングのために、不規則なリズム通知をECG読み取り値と相互参照してください