健康指标 - 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"
营养
关闭 汇总数据 时,各个营养数量样本(例如 Dietary Energy 或 Carbohydrates)可能包含 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"(基础胰岛素)