體能訓練 - JSON 匯出格式
JSON 匯出中體能訓練結構的文件
最後更新: 2026年10月31日
本頁內容
JSON 匯出將體能訓練儲存在 workouts 陣列中。
匯出版本
Health Auto Export 支援兩種體能訓練匯出版本:
- 版本 2(建議):具有更詳細中繼資料和結構化資料的增強格式
- 版本 1(舊版):為與現有工作流程相容而保留的較舊格式
體能訓練版本 2
版本 2 包含以下必填欄位和可選資料。範例在 本地化單位 關閉時使用;啟用後可能變更指標序列中的單位標籤。
基本結構
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Running",
"start": "2024-02-06 07:00:00 -0800",
"end": "2024-02-06 07:30:00 -0800",
"duration": 1800
}
必填欄位
id(字串):體能訓練的唯一識別碼name(字串):體能訓練類型名稱(例如 "Running"、"Cycling"、"Swimming")start(日期):體能訓練開始時間,格式為yyyy-MM-dd HH:mm:ss Zend(日期):體能訓練結束時間,格式為yyyy-MM-dd HH:mm:ss Zduration(數字):體能訓練時長(秒)
可選欄位
可選欄位取決於可用資料和匯出選擇:
記錄來源
{
"source": {
"name": "Workout App",
"identifier": "com.example.workouts"
}
}
source(物件):記錄體能訓練的 App 或裝置,含其名稱和 App 識別碼。各個指標讀數有單獨的來源字串,可能來自其他 App 或裝置。
位置資訊
{
"location": "Outdoor",
"isIndoor": false
}
location(字串):"Indoor"、"Outdoor"、"Pool"、"Open Water"之一isIndoor(布林值):體能訓練是否在室內進行
能量與強度
{
"activeEnergyBurned": {
"qty": 350,
"units": "kcal"
},
"totalEnergy": {
"qty": 450,
"units": "kcal"
},
"intensity": {
"qty": 8.5,
"units": "kcal/hr\u00b7kg"
}
}
activeEnergyBurned(物件):體能訓練期間消耗的活動卡路里totalEnergy(物件):消耗的總卡路里(活動 + 靜息)intensity(物件):代謝當量(MET)值
距離與速度
{
"distance": {
"qty": 3.5,
"units": "mi"
}
}
distance(物件):總距離speed(物件):由距離和時長計算的平均速度avgSpeed(物件):體能訓練全程的平均速度maxSpeed(物件):達到的最高速度
每個物件包含 qty 和 units。
海拔
{
"elevationUp": {
"qty": 500,
"units": "ft"
},
"elevationDown": {
"qty": 450,
"units": "ft"
}
}
elevationUp(物件):總爬升elevationDown(物件):總下降
單位: "ft"(英尺)或 "m"(公尺)
環境資料
{
"temperature": {
"qty": 72,
"units": "degF"
},
"humidity": {
"qty": 65,
"units": "%"
}
}
temperature(物件):體能訓練期間的環境溫度humidity(物件):相對濕度百分比
溫度單位: "degF"(華氏)或 "degC"(攝氏)
游泳專用欄位
{
"lapLength": {
"qty": 0.025,
"units": "mi"
},
"strokeStyle": "Freestyle",
"swolfScore": 45,
"salinity": "Fresh Water",
"totalSwimmingStrokeCount": {
"qty": 1200,
"units": "count"
},
"swimCadence": {
"qty": 30,
"units": "count/min"
}
}
lapLength(物件):每圈長度strokeStyle(字串):以下之一:"Backstroke""Breaststroke""Butterfly""Freestyle""Mixed""Kickboard""Unknown"
swolfScore(數字):游泳效率分數salinity(字串):"Fresh Water"或"Salt Water"totalSwimmingStrokeCount(物件):總划水次數swimCadence(物件):每分鐘划水次數
步數與步頻資料
{
"stepCount": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 5000,
"units": "count",
"source": "Apple Watch"
}
],
"stepCadence": {
"qty": 180,
"units": "count/min"
},
"flightsClimbed": {
"qty": 10,
"units": "count"
}
}
stepCount(陣列):隨時間變化的步數測量陣列stepCadence(物件):每分鐘步數flightsClimbed(物件):爬升的樓層數
心率資料
{
"heartRate": {
"min": {
"qty": 120,
"units": "count/min"
},
"avg": {
"qty": 150,
"units": "count/min"
},
"max": {
"qty": 175,
"units": "count/min"
}
},
"maxHeartRate": {
"qty": 175,
"units": "count/min"
},
"avgHeartRate": {
"qty": 150,
"units": "count/min"
},
"heartRateData": [
{
"date": "2024-02-06 07:00:00 -0800",
"Min": 120,
"Avg": 150,
"Max": 175,
"units": "count/min",
"source": "Apple Watch"
}
],
"heartRateRecovery": [
{
"date": "2024-02-06 07:30:00 -0800",
"Min": 140,
"Avg": 145,
"Max": 150,
"units": "count/min",
"source": "Apple Watch"
}
]
}
heartRate(物件):體能訓練期間最低、平均和最高心率摘要maxHeartRate(物件):體能訓練期間最高心率avgHeartRate(物件):體能訓練期間平均心率heartRateData(陣列):體能訓練的詳細測量,在體能訓練結束時終止heartRateRecovery(陣列):體能訓練結束後緊接著兩分鐘的單獨測量
摘要心率在可用時使用記錄的體能訓練值,否則回退到體能訓練的心率讀數。匯出的讀數包括暫停期間的測量,因此其峰值和平均值可能與摘要不同。
時間序列資料陣列
啟用「包含體能訓練指標」時,許多指標可作為時間序列陣列包含:
{
"activeEnergy": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 50,
"units": "kcal",
"source": "Apple Watch"
}
],
"basalEnergy": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 20,
"units": "kcal",
"source": "Apple Watch"
}
],
"cyclingCadence": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 90,
"units": "count/min",
"source": "Apple Watch"
}
],
"cyclingDistance": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 0.5,
"units": "mi",
"source": "Apple Watch"
}
],
"cyclingPower": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 200,
"units": "W",
"source": "Power Meter"
}
],
"cyclingSpeed": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 18,
"units": "mi/hr",
"source": "Apple Watch"
}
],
"swimDistance": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 25,
"units": "yd",
"source": "Apple Watch"
}
],
"swimStroke": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 20,
"units": "count",
"source": "Apple Watch"
}
],
"walkingAndRunningDistance": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 0.25,
"units": "mi",
"source": "Apple Watch"
}
]
}
QuantityData 結構:
date(日期):測量時間戳記qty(數字):數量值units(字串):測量單位source(字串,可選):資料來源裝置或 App
HeartRateData 結構:
date(日期):測量時間戳記Min(數字):最低心率Avg(數字):平均心率Max(數字):最高心率units(字串):單位(關閉本地化單位時為count/min)source(字串,可選):資料來源裝置或 App
路線資料
啟用「包含路線資料」且體能訓練有 GPS 資料時:
{
"route": [
{
"latitude": 37.7749,
"longitude": -122.4194,
"altitude": 50.5,
"course": 45.0,
"courseAccuracy": 5.0,
"horizontalAccuracy": 10.0,
"verticalAccuracy": 15.0,
"timestamp": "2024-02-06 07:00:00 -0800",
"speed": 7.0,
"speedAccuracy": 0.5
}
]
}
位置欄位:
latitude(數字):GPS 緯度座標longitude(數字):GPS 經度座標altitude(數字):海拔(公尺)course(數字):行進方向(度,0–360)courseAccuracy(數字):航向測量精度(度)horizontalAccuracy(數字):水平位置精度(公尺)verticalAccuracy(數字):垂直位置精度(公尺)timestamp(日期):記錄位置的時間speed(數字):速度(公尺/秒)speedAccuracy(數字):速度測量精度(m/s)
中繼資料
{
"metadata": {
"customField": {
"label": "value",
"quantity": 123
},
"anotherField": [
1,
2,
3
]
}
}
metadata(物件):與體能訓練關聯的其他自訂中繼資料
事件、活動與分段
版本 2 的 JSON 和 Markdown 匯出可能包含體能訓練 App 記錄的 events、segments、laps 和 activities。即使 包含體能訓練指標 關閉,這些仍可用。CSV 和 GPX 不包含這些記錄。
在開啟 包含體能訓練指標 並選擇相關指標時,區間還可能包含距離、活動能量、心率摘要以及活動時間配速或速度。值會區分記錄的測量與估計;不可用的值會被省略。
選擇距離時,splits 可能包含估計的公里和英里分段。它們可能與記錄 App 的分段不同,當短於目標距離時最後一段會標記為部分。缺少距離讀數或不支援的體能訓練類型可能無法計算分段。
體能訓練努力分數
版本 2 的 JSON 和 Markdown 匯出可包含選定的 體能訓練努力分數(effortScore)和 估計體能訓練努力分數(estimatedEffortScore)值。每個都是帶有 qty 和 units: "appleEffortScore" 的物件。
分數需要 iOS 18 或更高版本以及對 Apple 健康中相應資料的存取權限。整次體能訓練與活動分數是分開的。它們獨立於 時間分組 和 包含體能訓練指標;CSV 不包含它們。
在 瀏覽 → 體能訓練 中,開啟列表的匯出表或體能訓練的版本 2 匯出設定,然後使用 選擇匯出欄位 在匯出前選擇努力分數。
體能訓練指標時間分組
使用匯出版本 2 並啟用「包含體能訓練指標」時,可以控制時間序列資料的粒度:
- 分鐘:按時鐘分鐘分組體能訓練指標。第一分鐘和最後一分鐘可能包含體能訓練開始前或結束後剛過的幾秒。
- 秒:按時鐘秒分組體能訓練指標,每個時間戳記標記該秒的開始。第一秒和最後一秒可能包含體能訓練剛外側的小數秒。檔案比按分鐘分組更大。
活動和靜息能量在每個時間組中使用與其他體能訓練指標相同的合併合計。來自多個裝置或 App 的讀數會一併包含。
體能訓練版本 1(舊版)
版本 1 使用更簡單的結構。對於新匯出,建議版本 2。
版本 1 結構
{
"name": "Running",
"start": "2024-02-06 07:00:00 -0800",
"end": "2024-02-06 07:30:00 -0800",
"totalEnergy": {
"qty": 450,
"units": "kcal"
},
"activeEnergy": {
"qty": 350,
"units": "kcal"
},
"distance": {
"qty": 3.5,
"units": "mi"
},
"heartRateData": [
{
"date": "2024-02-06 07:00:00 -0800",
"qty": 150,
"units": "bpm"
}
],
"route": [
{
"lat": 37.7749,
"lon": -122.4194,
"altitude": 50.5,
"timestamp": "2024-02-06 07:00:00 -0800"
}
]
}