운동 - 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 Z형식의 운동 시작 시각end(날짜):yyyy-MM-dd HH:mm:ss Z형식의 운동 종료 시각duration(숫자): 초 단위의 운동 지속 시간
선택 필드
선택 필드는 사용 가능한 데이터와 내보내기 선택에 따라 달라집니다:
기록 소스
{
"source": {
"name": "Workout App",
"identifier": "com.example.workouts"
}
}
source(객체): 운동을 기록한 앱 또는 기기. 이름과 앱 식별자를 포함합니다. 개별 지표 측정값에는 별도의 소스 문자열이 있으며 다른 앱 또는 기기에서 온 것일 수 있습니다.
위치 정보
{
"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(배열): 운동 종료 직후 2분 동안의 별도 측정값
요약 심박수는 사용 가능한 경우 기록된 운동 값을 쓰고, 없으면 운동의 심박수 측정값으로 대체합니다. 내보낸 측정값에는 일시 정지 중 측정이 포함되므로 최고값과 평균이 요약과 다를 수 있습니다.
시계열 데이터 배열
"운동 지표 포함"이 켜져 있으면 많은 지표를 시계열 배열로 포함할 수 있습니다:
{
"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(문자열, 선택): 데이터 소스 기기 또는 앱
HeartRateData 구조:
date(날짜): 측정 타임스탬프Min(숫자): 최소 심박수Avg(숫자): 평균 심박수Max(숫자): 최대 심박수units(문자열): 단위(단위 현지화가 꺼진 경우count/min)source(문자열, 선택): 데이터 소스 기기 또는 앱
경로 데이터
"경로 데이터 포함"이 켜져 있고 운동에 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 내보내기에는 운동 앱이 기록한 events, segments, laps, activities가 포함될 수 있습니다. 이는 운동 지표 포함이 꺼져 있어도 사용할 수 있습니다. CSV와 GPX에는 이러한 기록이 포함되지 않습니다.
운동 지표 포함이 켜져 있고 관련 지표가 선택되어 있으면 인터벌에 거리, 활동 에너지, 심박수 요약, 활동 시간 페이스 또는 속도도 포함될 수 있습니다. 값은 기록된 측정과 추정을 구분하며, 사용할 수 없는 값은 생략됩니다.
거리가 선택되어 있으면 splits에 추정된 킬로미터 및 마일 스플릿이 포함될 수 있습니다. 기록 앱의 스플릿과 다를 수 있으며, 마지막 스플릿은 목표 거리보다 짧을 때 부분으로 표시됩니다. 거리 측정값이 없거나 지원되지 않는 운동 유형에서는 스플릿 계산이 불가능할 수 있습니다.
운동 노력 점수
버전 2 JSON 및 Markdown 내보내기에는 선택한 운동 노력 점수(effortScore)와 예상 운동 노력 점수(estimatedEffortScore) 값을 포함할 수 있습니다. 각각 qty와 units: "appleEffortScore"를 가진 객체입니다.
점수에는 iOS 18 이상과 Apple Health에서 해당 데이터에 대한 접근이 필요합니다. 전체 운동 점수와 활동 점수는 별개입니다. 시간 그룹화 및 운동 지표 포함과 독립적이며, CSV에는 포함되지 않습니다.
찾아보기 → 운동에서 목록의 내보내기 시트 또는 운동의 버전 2 내보내기 설정을 연 다음, 내보내기 전에 내보내기 필드 선택으로 노력 점수를 선택하세요.
운동 지표 시간 그룹화
내보내기 버전 2에서 "운동 지표 포함"이 켜져 있으면 시계열 데이터의 세분성을 제어할 수 있습니다:
- 분: 시계의 분 단위로 운동 지표를 그룹화합니다. 첫 분과 마지막 분에는 운동 시작 직전 또는 종료 직후의 몇 초가 포함될 수 있습니다.
- 초: 시계의 초 단위로 운동 지표를 그룹화하며, 각 타임스탬프는 해당 초의 시작을 표시합니다. 첫 초와 마지막 초에는 운동 바로 바깥의 소수 초가 포함될 수 있습니다. 파일은 분 그룹화보다 커집니다.
활동 및 안정 에너지는 각 시간 그룹에서 다른 운동 지표와 같은 결합 합계를 사용합니다. 둘 이상의 기기 또는 앱의 측정값이 함께 포함됩니다.
운동 버전 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"
}
]
}