도움말 센터 HealthyApps
한국어
도움말 센터
메인 웹사이트 ↗

도움말 검색

운동 - JSON 내보내기 형식

JSON 내보내기에서 운동 구조에 대한 문서

최근 업데이트: 2026년 10월 31일

이 페이지에서
내보내기 버전
운동 버전 2 운동 버전 2 기본 구조필수 필드선택 필드운동 지표 시간 그룹화
운동 버전 1 (레거시) 운동 버전 1 (레거시) 버전 1 구조
관련 문서

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

관련 문서