把你的 Apple Health 匯出檔轉成 CSV 和 JSON
從「健康」App 選取 export.zip,就能得到可直接用於試算表的檔案:每個指標的每日總計、以每天分鐘數表示的睡眠和其他類別、每一次體能訓練,以及你選的任何指標的原始記錄。它免費,而且完全在這個瀏覽器內執行。這個頁面不允許發出網路請求,所以你的健康資料絕不會離開你的電腦。
你的檔案
單一指標的每一筆記錄
舉例來說,心率每天有數千筆樣本。選一個指標,就能得到包含每筆樣本、其來源與時間的 CSV。
你的匯出檔包含什麼
我要怎麼從 iPhone 取得 export.zip?
- 打開健康 App,點右上角的照片或姓名縮寫。
- 點最下方的匯出所有健康資料,再點匯出.
- 等待檔案建立完成。資料多年的話,可能需要好幾分鐘。
- 用 AirDrop 把
export.zip傳到你的電腦,或把它存到「檔案」App,再用 iPhone 上的 Safari 開啟這個頁面。
較大的匯出檔最好在電腦上處理。如果匯出檔有好幾 GB,手機瀏覽器可能會記憶體不足。
每個檔案裡有什麼?
| 檔案 | 每一列代表 | 欄位 |
|---|---|---|
apple-health-daily-metrics.csv | 每個日期、指標、來源和單位 | date, type, source, unit, samples, sum, average, min, max |
apple-health-daily-categories.csv | 每個日期、類別、來源和數值 | date, type, source, value(睡眠:InBed, AsleepCore, AsleepDeep, AsleepREM, Awake), samples, minutes |
apple-health-workouts.csv | 每次訓練 | start, end, activity, minutes, source, distance, distance unit, active energy, energy unit, average heart rate |
apple-health-summary.json | 以上全部 | 同樣的資料列轉成 JSON,另附每種類型的清單,包含其記錄筆數和日期範圍 |
apple-health-<metric>.csv | 每筆樣本,針對你選的指標 | type, source, unit, value, start, end |
日期是每筆樣本開始的那一天,依你的手機記錄時所用的時區計算。類型名稱省略了 Apple 的前綴,所以 HKQuantityTypeIdentifierStepCount 會變成 StepCount。一天內會累加的項目(步數、距離、活動能量、飲食營養素)請用 sum,讀數類的項目(心率、體重、血氧)則用 average、min 和 max。
為什麼我的步數比「健康」App 顯示的還多?
因為你的 iPhone 和 Apple Watch 都會計算步數,而 Apple Health 兩邊的樣本都會保留。「健康」App 在兩者重疊時會偏重其中一個來源,顯示單一總數。匯出檔不會幫你做這件事,所以這個轉換器把每個來源各放一列,不會把它們相加。要看每日步數,請用單一來源(通常是你的手錶)的那一列,或取兩者中較高的,不要把兩者加總。
我的資料會被上傳嗎?
不會。轉換器是兩個在你電腦上執行的腳本(頁面本身和剖析器,兩者都能直接閱讀)。這個頁面採用會封鎖所有網路連線的安全政策,所以就算有程式錯誤,也無法把你的檔案送到任何地方,頁面上也沒有任何分析工具。頁面載入後你可以關掉 Wi-Fi,運作完全一樣。
能處理多大的匯出檔?
好幾 GB 都行。它以串流方式讀取 zip,而不是整個載入,所以不論 export.xml 多大,記憶體用量都很低,Apple 用於大型匯出的大檔案(zip64)格式也支援。在我們的測試中,1.1 GB 的匯出檔(超過四百萬筆記錄)大約花了 20 秒。需要新版的 Safari(16.4 或更新)、Chrome、Edge 或 Firefox。
想要不用每次都匯出嗎?
「健康」App 的匯出是完整備份,每次都從頭重新建立。Marrow Health 直接在你的 iPhone 上讀取 Apple Health,所以你隨時可以把任何指標匯出成 CSV 或 JSON,把體能訓練路線匯出成 GPX,每日總計還會與 Apple 自己的數字核對(步數不會重複計算)。它也能依排程把你的資料推送到某個網址,或讓 AI 讀取。這些都是免費的。
更多選項說明:匯出 Apple Health 資料的所有方式、排程匯出,以及讓 AI 智慧代理存取.