帮助中心 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(字符串,可用时):记录样本的 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"(基础胰岛素)

相关文档