ヘルプセンター HealthyApps
日本語
ヘルプセンター
メインサイト ↗

ヘルプを検索

ヘルス指標 - JSON エクスポート形式

JSON エクスポートにおけるヘルス指標構造のドキュメント

最終更新: 2026年10月31日

このページの内容
指標名の形式
構造 構造 共通フィールド
特殊な指標形式 特殊な指標形式 血圧心拍数心拍変動睡眠分析血糖値栄養性行為手洗い歯磨きインスリン投与
関連ドキュメント

JSON エクスポートはヘルス指標を metrics 配列に保存します。

指標名の形式

JSON エクスポートのすべての指標名は snake_case 形式(小文字とアンダースコア)を使います。例:

  • "Step Count" は "step_count" になります
  • "Blood Pressure" は "blood_pressure" になります
  • "Heart Rate" は "heart_rate" になります
  • "Walking + Running Distance" は "walking_running_distance" になります

構造

metrics 配列には、特定のヘルス指標タイプを表すオブジェクトが含まれます。ほとんどのヘルス指標は共通の構造に従います:

{
  "name": "step_count",
  "units": "count",
  "data": [
    {
      "qty": 8500,
      "date": "2024-02-06 14:30:00 -0800",
      "source": "Apple Watch"
    }
  ]
}

共通フィールド

  • name(文字列): snake_case 形式のヘルス指標名(例: "step_count"、"heart_rate"、"active_energy")
  • units(文字列): 測定単位(例: "count"、"count/min"、"kcal")
  • data(配列): データポイントの配列。各要素には次が含まれます:
    • qty(数値): 数量の値
    • date(日付): yyyy-MM-dd HH:mm:ss Z 形式のタイムスタンプ
    • source(文字列、利用可能な場合): サンプルを記録したアプリまたはデバイス

特殊な指標形式

一部のヘルス指標は、共通形式と異なる独自の構造を持ちます:

血圧

血圧の測定値には収縮期と拡張期の両方が含まれます:

{
  "name": "blood_pressure",
  "units": "mmHg",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "start": "2024-02-06 14:30:00 -0800",
      "end": "2024-02-06 14:30:00 -0800",
      "systolic": 120,
      "diastolic": 80,
      "source": "Health"
    }
  ]
}

フィールド:

  • systolic(数値): 収縮期(上)の血圧測定値。要約エクスポートでは時間グループ内の測定値の平均を使います。
  • diastolic(数値): 拡張期(下)の血圧測定値。要約エクスポートでは時間グループ内の測定値の平均を使います。

心拍数

心拍数データには最小、平均、最大値が含まれます:

{
  "name": "heart_rate",
  "units": "count/min",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "Min": 65,
      "Avg": 72,
      "Max": 85,
      "source": "Apple Watch"
    }
  ]
}

フィールド:

  • Min(数値): 測定期間中の最小心拍数
  • Avg(数値): 測定期間中の平均心拍数
  • Max(数値): 測定期間中の最大心拍数

心拍変動

データを要約 がオフの場合、心拍変動(SDNN)の JSON エクスポートには利用可能なビートツービート測定が含まれることがあります。これには Apple Health での 心拍数シリーズ の読み取りアクセスが必要です。

要約エクスポート、CSV エクスポート、Recovery HRV にはビートツービート測定は含まれません。

睡眠分析

睡眠データの構造は、データを要約 がオンかオフかによって異なります。

データを要約オン

データを要約 がオンの場合、睡眠データは日ごとに要約されます。同じステージの時間が加算されます。総睡眠は asleep、core、deep、REM の合計です。JSON は各日を保持します。CSV では、より粗い時間グループはそのグループ内の最新の日を示します:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "date": "2024-02-06 00:00:00 -0800",
      "totalSleep": 7.5,
      "asleep": 0.5,
      "core": 3.5,
      "deep": 1.5,
      "rem": 2.0,
      "sleepStart": "2024-02-05 23:00:00 -0800",
      "sleepEnd": "2024-02-06 06:30:00 -0800",
      "inBed": 8.0,
      "inBedStart": "2024-02-05 22:45:00 -0800",
      "inBedEnd": "2024-02-06 06:45:00 -0800",
      "awake": 0.0,
      "source": "Apple Watch"
    }
  ]
}

フィールド:

  • totalSleep(数値): 時間単位の総睡眠時間
  • asleep(数値): 記録された睡眠ステージのない睡眠時間(時間)
  • core(数値): 時間単位のコア睡眠時間
  • deep(数値): 時間単位の深い睡眠時間
  • rem(数値): 時間単位の REM 睡眠時間
  • awake(数値): 時間単位の覚醒時間
  • sleepStart(日付): 実際に睡眠が始まった時刻
  • sleepEnd(日付): 実際に睡眠が終わった時刻
  • inBed(数値): 時間単位の総ベッド時間
  • inBedStart(日付): ベッドに入った時刻
  • inBedEnd(日付): ベッドを出た時刻

データを要約オフ

データを要約 がオフの場合、個別の睡眠セグメントが含まれます:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "date": "2024-02-05 23:00:00 -0800",
      "start": "2024-02-05 23:00:00 -0800",
      "end": "2024-02-05 23:30:00 -0800",
      "startDate": "2024-02-05 23:00:00 -0800",
      "endDate": "2024-02-05 23:30:00 -0800",
      "qty": 0.5,
      "value": "Core",
      "source": "Apple Watch"
    }
  ]
}

フィールド:

  • date、start、startDate(日付): 睡眠セグメントの開始時刻
  • end、endDate(日付): 睡眠セグメントの終了時刻
  • source(文字列): セグメントを記録したアプリまたはデバイス
  • qty(数値): 時間単位のセグメントの長さ
  • value(文字列): 睡眠状態。次のいずれか:
    • "Awake"
    • "Asleep"(未分類の睡眠フェーズ)
    • "In Bed"
    • "Core"
    • "REM"
    • "Deep"
    • "Unspecified"

注: "Asleep" は総睡眠時間ではなく、未分類の睡眠フェーズを指します。データソースが睡眠フェーズ追跡をサポートしていない場合に発生することがあります。

血糖値

血糖値の測定には食事のタイミング情報が含まれます:

{
  "name": "blood_glucose",
  "units": "mg/dL",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 95,
      "mealTime": "Before Meal",
      "source": "Health"
    }
  ]
}

フィールド:

  • qty(数値): 血糖値
  • mealTime(文字列): 次のいずれか:
    • "Before Meal"
    • "After Meal"
    • "Unspecified"

栄養

データを要約 がオフの場合、個別の栄養数量サンプル(例: Dietary Energy または Carbohydrates)には、Apple Health に記録された食事の詳細が含まれることがあります。例:

{
  "name": "dietary_energy",
  "units": "kcal",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 240,
      "source": "Lose It!",
      "foodType": "Boneless, Skinless Grilled Chicken Breast"
    }
  ]
}

フィールド:

  • qty(数値): サンプルの栄養素量
  • foodType(文字列、任意): 利用可能な場合、ソースアプリが記録した食品名

データを要約 がオンの場合、栄養の合計に foodType は含まれません。

性行為

性行為のエントリは保護の使用を追跡します:

{
  "name": "sexual_activity",
  "units": "count",
  "data": [
    {
      "date": "2024-02-06 00:00:00 -0800",
      "Unspecified": 0,
      "Protection Used": 1,
      "Protection Not Used": 0,
      "source": "Health"
    }
  ]
}

フィールド:

  • Unspecified(数値): その日の保護状態が不明なイベント数
  • Protection Used(数値): その日の保護を使用したイベント数
  • Protection Not Used(数値): その日の保護を使用しなかったイベント数

要約エクスポートは各カレンダー日を数えます。JSON は各日を保持します。CSV では、より粗い時間グループはそのグループ内の最新の日を示します。

手洗い

手洗いイベントは完了状態を追跡します:

{
  "name": "handwashing",
  "units": "s",
  "data": [
    {
      "date": "2024-02-06 12:00:00 -0800",
      "start": "2024-02-06 12:00:00 -0800",
      "end": "2024-02-06 12:00:25 -0800",
      "qty": 25,
      "value": "Completed",
      "source": "Apple Watch"
    }
  ]
}

フィールド:

  • qty(数値): 秒単位の時間。要約エクスポートでは時間グループ内の平均時間を使います。
  • value(文字列): セッションが 20 秒を超える場合は "Completed"、それ以外は "Incomplete"

歯磨き

歯磨きイベントは完了状態を追跡します:

{
  "name": "toothbrushing",
  "units": "s",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:02:10 -0800",
      "qty": 130,
      "value": "Completed",
      "source": "Health"
    }
  ]
}

フィールド:

  • qty(数値): 秒単位の時間。要約エクスポートでは時間グループ内の平均時間を使います。
  • value(文字列): セッションが少なくとも 2 分続く場合は "Completed"、それ以外は "Incomplete"

インスリン投与

インスリン投与のエントリには投与理由が含まれます:

{
  "name": "insulin_delivery",
  "units": "IU",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 5,
      "reason": "Bolus",
      "source": "Health"
    }
  ]
}

フィールド:

  • qty(数値): 投与されたインスリン量。要約エクスポートでは時間グループ内の量を加算します。
  • reason(文字列): 次のいずれか:
    • "Bolus"(食事時インスリン)
    • "Basal"(基礎インスリン)

関連ドキュメント