锻炼 - 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"
}
]
}