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

도움말 검색

건강 지표 - JSON 내보내기 형식

JSON 내보내기에서 건강 지표 구조에 대한 문서

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

이 페이지에서
지표 이름 형식
구조 구조 공통 필드
특수 지표 형식 특수 지표 형식 혈압심박수심박 변이도수면 분석혈당영양성행위손 씻기양치질인슐린 투여
관련 문서

JSON 내보내기는 건강 지표를 metrics 배열에 저장합니다.

지표 이름 형식

JSON 내보내기의 모든 지표 이름은 snake_case 형식(소문자와 밑줄)을 사용합니다. 예:

  • "Step Count"는 "step_count"가 됩니다
  • "Blood Pressure"는 "blood_pressure"가 됩니다
  • "Heart Rate"는 "heart_rate"가 됩니다
  • "Walking + Running Distance"는 "walking_running_distance"가 됩니다

구조

metrics 배열에는 특정 건강 지표 유형을 나타내는 객체가 포함됩니다. 대부분의 건강 지표는 공통 구조를 따릅니다:

{
  "name": "step_count",
  "units": "count",
  "data": [
    {
      "qty": 8500,
      "date": "2024-02-06 14:30:00 -0800",
      "source": "Apple Watch"
    }
  ]
}

공통 필드

  • name (문자열): snake_case 형식의 건강 지표 이름(예: "step_count", "heart_rate", "active_energy")
  • units (문자열): 측정 단위(예: "count", "count/min", "kcal")
  • data (배열): 데이터 포인트 배열. 각 항목에는 다음이 포함됩니다:
    • qty (숫자): 수량 값
    • date (날짜): yyyy-MM-dd HH:mm:ss Z 형식의 타임스탬프
    • source (문자열, 사용 가능한 경우): 샘플을 기록한 앱 또는 기기

특수 지표 형식

일부 건강 지표는 공통 형식과 다른 고유 구조를 가집니다:

혈압

혈압 측정값에는 수축기 값과 이완기 값이 모두 포함됩니다:

{
  "name": "blood_pressure",
  "units": "mmHg",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "start": "2024-02-06 14:30:00 -0800",
      "end": "2024-02-06 14:30:00 -0800",
      "systolic": 120,
      "diastolic": 80,
      "source": "Health"
    }
  ]
}

필드:

  • systolic (숫자): 수축기(위) 혈압 측정값. 요약 내보내기는 시간 그룹 내 측정값의 평균을 사용합니다.
  • diastolic (숫자): 이완기(아래) 혈압 측정값. 요약 내보내기는 시간 그룹 내 측정값의 평균을 사용합니다.

심박수

심박수 데이터에는 최소, 평균, 최대 값이 포함됩니다:

{
  "name": "heart_rate",
  "units": "count/min",
  "data": [
    {
      "date": "2024-02-06 14:30:00 -0800",
      "Min": 65,
      "Avg": 72,
      "Max": 85,
      "source": "Apple Watch"
    }
  ]
}

필드:

  • Min (숫자): 측정 기간 중 최소 심박수
  • Avg (숫자): 측정 기간 중 평균 심박수
  • Max (숫자): 측정 기간 중 최대 심박수

심박 변이도

데이터 요약이 꺼져 있으면 심박 변이도(SDNN)의 JSON 내보내기에 사용 가능한 박동 간(beat-to-beat) 측정값이 포함될 수 있습니다. 여기에는 Apple Health에서 심장 박동 시리즈 읽기 권한이 필요합니다.

요약 내보내기, CSV 내보내기, Recovery HRV에는 박동 간 측정값이 포함되지 않습니다.

수면 분석

수면 데이터 구조는 데이터 요약이 켜져 있는지 꺼져 있는지에 따라 달라집니다.

데이터 요약 켜짐

데이터 요약이 켜져 있으면 수면 데이터는 일별로 요약됩니다. 같은 단계의 시간은 합산됩니다. 총 수면은 asleep, core, deep, REM을 합한 값입니다. JSON은 각 날짜를 유지합니다. CSV에서는 더 거친 시간 그룹이 해당 그룹의 최신 날짜를 표시합니다:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "date": "2024-02-06 00:00:00 -0800",
      "totalSleep": 7.5,
      "asleep": 0.5,
      "core": 3.5,
      "deep": 1.5,
      "rem": 2.0,
      "sleepStart": "2024-02-05 23:00:00 -0800",
      "sleepEnd": "2024-02-06 06:30:00 -0800",
      "inBed": 8.0,
      "inBedStart": "2024-02-05 22:45:00 -0800",
      "inBedEnd": "2024-02-06 06:45:00 -0800",
      "awake": 0.0,
      "source": "Apple Watch"
    }
  ]
}

필드:

  • totalSleep (숫자): 시간 단위의 총 수면 시간
  • asleep (숫자): 기록된 수면 단계가 없는 수면 시간(시간)
  • core (숫자): 코어 수면 시간(시간)
  • deep (숫자): 깊은 수면 시간(시간)
  • rem (숫자): REM 수면 시간(시간)
  • awake (숫자): 깨어 있던 시간(시간)
  • sleepStart (날짜): 실제로 수면이 시작된 시각
  • sleepEnd (날짜): 실제로 수면이 끝난 시각
  • inBed (숫자): 침대에 있던 총 시간(시간)
  • inBedStart (날짜): 침대에 들어간 시각
  • inBedEnd (날짜): 침대에서 나온 시각

데이터 요약 꺼짐

데이터 요약이 꺼져 있으면 개별 수면 구간이 포함됩니다:

{
  "name": "sleep_analysis",
  "units": "hr",
  "data": [
    {
      "date": "2024-02-05 23:00:00 -0800",
      "start": "2024-02-05 23:00:00 -0800",
      "end": "2024-02-05 23:30:00 -0800",
      "startDate": "2024-02-05 23:00:00 -0800",
      "endDate": "2024-02-05 23:30:00 -0800",
      "qty": 0.5,
      "value": "Core",
      "source": "Apple Watch"
    }
  ]
}

필드:

  • date, start, startDate (날짜): 수면 구간의 시작 시각
  • end, endDate (날짜): 수면 구간의 종료 시각
  • source (문자열): 구간을 기록한 앱 또는 기기
  • qty (숫자): 구간의 지속 시간(시간)
  • value (문자열): 수면 상태. 다음 중 하나:
    • "Awake"
    • "Asleep" (분류되지 않은 수면 단계)
    • "In Bed"
    • "Core"
    • "REM"
    • "Deep"
    • "Unspecified"

참고: "Asleep"은 총 수면 시간이 아니라 분류되지 않은 수면 단계를 가리킵니다. 데이터 소스가 수면 단계 추적을 지원하지 않을 때 발생할 수 있습니다.

혈당

혈당 측정값에는 식사 시점 정보가 포함됩니다:

{
  "name": "blood_glucose",
  "units": "mg/dL",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 95,
      "mealTime": "Before Meal",
      "source": "Health"
    }
  ]
}

필드:

  • qty (숫자): 혈당 수치
  • mealTime (문자열): 다음 중 하나:
    • "Before Meal"
    • "After Meal"
    • "Unspecified"

영양

데이터 요약이 꺼져 있으면 개별 영양 수량 샘플(예: Dietary Energy 또는 Carbohydrates)에 Apple Health에 기록된 음식 세부 정보가 포함될 수 있습니다. 예:

{
  "name": "dietary_energy",
  "units": "kcal",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 240,
      "source": "Lose It!",
      "foodType": "Boneless, Skinless Grilled Chicken Breast"
    }
  ]
}

필드:

  • qty (숫자): 샘플의 영양소 양
  • foodType (문자열, 선택): 사용 가능한 경우 소스 앱이 기록한 음식 이름

데이터 요약이 켜져 있으면 영양 합계에 foodType이 포함되지 않습니다.

성행위

성행위 항목은 보호 사용을 추적합니다:

{
  "name": "sexual_activity",
  "units": "count",
  "data": [
    {
      "date": "2024-02-06 00:00:00 -0800",
      "Unspecified": 0,
      "Protection Used": 1,
      "Protection Not Used": 0,
      "source": "Health"
    }
  ]
}

필드:

  • Unspecified (숫자): 해당 날짜에 보호 상태가 알 수 없는 이벤트 수
  • Protection Used (숫자): 해당 날짜에 보호를 사용한 이벤트 수
  • Protection Not Used (숫자): 해당 날짜에 보호를 사용하지 않은 이벤트 수

요약 내보내기는 각 달력 날짜를 셉니다. JSON은 각 날짜를 유지합니다. CSV에서는 더 거친 시간 그룹이 해당 그룹의 최신 날짜를 표시합니다.

손 씻기

손 씻기 이벤트는 완료 상태를 추적합니다:

{
  "name": "handwashing",
  "units": "s",
  "data": [
    {
      "date": "2024-02-06 12:00:00 -0800",
      "start": "2024-02-06 12:00:00 -0800",
      "end": "2024-02-06 12:00:25 -0800",
      "qty": 25,
      "value": "Completed",
      "source": "Apple Watch"
    }
  ]
}

필드:

  • qty (숫자): 초 단위 지속 시간. 요약 내보내기는 시간 그룹 내 평균 지속 시간을 사용합니다.
  • value (문자열): 세션이 20초를 초과하면 "Completed", 그렇지 않으면 "Incomplete"

양치질

양치질 이벤트는 완료 상태를 추적합니다:

{
  "name": "toothbrushing",
  "units": "s",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:02:10 -0800",
      "qty": 130,
      "value": "Completed",
      "source": "Health"
    }
  ]
}

필드:

  • qty (숫자): 초 단위 지속 시간. 요약 내보내기는 시간 그룹 내 평균 지속 시간을 사용합니다.
  • value (문자열): 세션이 최소 2분 지속되면 "Completed", 그렇지 않으면 "Incomplete"

인슐린 투여

인슐린 투여 항목에는 투여 사유가 포함됩니다:

{
  "name": "insulin_delivery",
  "units": "IU",
  "data": [
    {
      "date": "2024-02-06 08:00:00 -0800",
      "start": "2024-02-06 08:00:00 -0800",
      "end": "2024-02-06 08:00:00 -0800",
      "qty": 5,
      "reason": "Bolus",
      "source": "Health"
    }
  ]
}

필드:

  • qty (숫자): 투여된 인슐린 양. 요약 내보내기는 시간 그룹 내 양을 합산합니다.
  • reason (문자열): 다음 중 하나:
    • "Bolus" (식사 시 인슐린)
    • "Basal" (기초 인슐린)

관련 문서