ヘルス指標 - 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"(基礎インスリン)