健康指標 - 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 Zsource(字串,可用時):記錄樣本的 App 或裝置
特殊指標格式
某些健康指標具有與通用格式不同的獨特結構:
血壓
血壓讀數包含收縮壓和舒張壓:
{
"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 健康中的 心跳序列 讀取權限。
彙總匯出、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(字串):記錄該分段的 App 或裝置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"
營養
關閉 彙總資料 時,各個營養數量樣本(例如飲食能量或碳水化合物)可能包含 Apple 健康中記錄的食物詳情。例如:
{
"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(字串,可選):可用時由來源 App 記錄的食物名稱
開啟 彙總資料 時,營養合計不包含 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"(基礎胰島素)