幫助中心 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"(基礎胰島素)

相關文件