症狀 - JSON 匯出格式

關於 JSON 匯出中症狀結構的文件

Last updated: February 6, 2026

On this page

症狀

症狀資料包括您在 Apple Health 中記錄的所有症狀,如頭痛、疲勞、噁心和其他健康症狀。在 JSON 匯出中,症狀儲存在 symptoms 陣列中。

結構

每個症狀項目包含有關其發生時間、嚴重程度和資料來源的資訊:

{
  "start": "2024-02-06 10:00:00 -0800",
  "end": "2024-02-06 12:00:00 -0800",
  "name": "Headache",
  "severity": "Moderate",
  "userEntered": true,
  "source": "Health Auto Export"
}

欄位

必填欄位

  • start (Date): 症狀的開始時間,格式為 yyyy-MM-dd HH:mm:ss Z
  • end (Date): 症狀的結束時間,格式為 yyyy-MM-dd HH:mm:ss Z
  • name (String): 症狀名稱(例如:"Headache"、"Fatigue"、"Nausea"、"Fever")
  • severity (String): 症狀的嚴重程度級別(例如:"Mild"、"Moderate"、"Severe")
  • userEntered (Boolean): 症狀是由使用者手動輸入的(true)還是自動記錄的(false
  • source (String): 症狀資料的來源(例如:應用程式名稱、裝置名稱或 "Health Auto Export")

症狀持續時間

症狀可以記錄為:

  • 時間點: 當 startend 相同時,表示瞬間症狀
  • 基於持續時間: 當 startend 不同時,表示症狀持續了一段時間

項目範例

單一時刻症狀

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:30:00 -0800",
  "name": "Dizziness",
  "severity": "Mild",
  "userEntered": true,
  "source": "Health Auto Export"
}

基於持續時間的症狀

{
  "start": "2024-02-06 08:00:00 -0800",
  "end": "2024-02-06 18:00:00 -0800",
  "name": "Fatigue",
  "severity": "Moderate",
  "userEntered": true,
  "source": "Health Auto Export"
}

多個症狀

[
  {
    "start": "2024-02-06 09:00:00 -0800",
    "end": "2024-02-06 11:00:00 -0800",
    "name": "Headache",
    "severity": "Severe",
    "userEntered": true,
    "source": "Health Auto Export"
  },
  {
    "start": "2024-02-06 10:00:00 -0800",
    "end": "2024-02-06 10:00:00 -0800",
    "name": "Nausea",
    "severity": "Mild",
    "userEntered": true,
    "source": "Health Auto Export"
  }
]

常見症狀

Apple Health 支援追蹤各種症狀,包括但不限於:

  • Headache
  • Fatigue
  • Nausea
  • Dizziness
  • Fever
  • Cough
  • Sore Throat
  • Runny Nose
  • Body Aches
  • Chills
  • Shortness of Breath
  • Chest Pain
  • Abdominal Pain
  • Joint Pain
  • Muscle Pain

嚴重程度級別

嚴重程度級別可能因症狀的記錄方式而異,但常見值包括:

  • Mild: 輕微不適,不會顯著影響日常活動
  • Moderate: 明顯不適,可能影響某些日常活動
  • Severe: 嚴重不適,嚴重影響日常活動

資料來源

source 欄位指示症狀資料的來源:

  • 使用者輸入: 當 userEnteredtrue 時,症狀由您手動記錄
  • 應用程式記錄: 當 userEnteredfalse 時,症狀可能由連接的健康應用程式記錄
  • 裝置記錄: 某些裝置或應用程式可能會自動偵測並記錄某些症狀

使用場景

症狀資料可用於:

  • 健康追蹤: 監控症狀隨時間變化的模式
  • 醫療預約: 與醫療保健提供者分享症狀歷史
  • 相關性分析: 識別症狀與其他健康指標之間的關係
  • 疾病追蹤: 在疾病期間追蹤症狀以監控恢復情況
  • 慢性病管理: 監控與慢性病相關的症狀

提示

  • 保持一致: 使用一致的命名和嚴重程度級別以便更好地分析
  • 記錄時間: 準確的開始和結束時間有助於識別模式
  • 與其他資料結合: 將症狀與其他健康指標(例如:體溫、心率)進行交叉引用,以獲得全面的健康洞察

相關文件