헬스 커넥트 데이터 유형

헬스 커넥트는 건강 및 피트니스 데이터와 의료 기록 데이터를 모두 저장하고 구조화합니다. 앱의 요구사항을 계획할 수 있도록 먼저 헬스 커넥트에서 제공하는 데이터 유형과 권한을 이해하는 것이 중요합니다.

개발 후 Play 스토어에 앱을 게시할 준비를 할 때 앱의 데이터 사용을 선언하고 앱이 사용하는 헬스 커넥트 데이터 유형에 대한 액세스 권한을 선언해야 합니다. 그렇지 않으면 특별 승인이 필요하므로 앱이 헬스 커넥트 데이터 유형에 액세스할 수 없다는 오류 메시지가 사용자에게 표시될 수 있습니다.

자세한 내용은 Play Console에서 건강 앱 선언 작성하기를 참고하세요.

데이터 유형 카테고리

헬스 커넥트는 가능한 한 다양한 데이터를 제공하기 위해 대부분의 건강 및 피트니스 앱에서 사용되는 데이터 유형을 지원합니다. 헬스 커넥트는 건강 및 피트니스 데이터를 포괄적으로 확인하고 저장하는 것을 목표로 합니다. 이러한 데이터 유형은 다음 카테고리로 분류됩니다.

표: 헬스 커넥트 데이터 유형 카테고리
카테고리 설명
directions_run 활동 사용자가 하는 모든 활동을 캡처합니다. 달리기, 수영과 같은 건강 및 피트니스 활동을 포함할 수 있습니다.
straighten 신체 측정 사용자의 체중 및 기초 대사율과 같은 신체와 관련된 일반적인 데이터를 캡처합니다.
비옥한 월경 주기 추적 월경 주기 및 관련 데이터 포인트(예: 배란 테스트의 바이너리 결과)를 캡처합니다.
식료품 Nutrition 수분 섭취 및 영양 데이터 유형을 캡처합니다. 수분 섭취는 사용자가 한 번에 마신 물의 양을 나타냅니다. 영양 데이터 유형에는 칼로리, 당분, 마그네슘과 같은 선택 필드가 포함되어 있습니다.
sleep_auto 수면 사용자의 수면 시간 및 유형과 관련된 인터벌 데이터를 캡처합니다.
vital_signs Vitals 사용자의 일반적인 건강에 관한 필수 정보를 캡처합니다. 여기에는 체온, 혈당, 혈압, 혈중 산소 포화도 등의 데이터가 포함됩니다.
마음챙김 웰빙 사용자의 정신 건강 및 웰빙과 관련된 데이터를 캡처합니다.

데이터 유형 필드

헬스 커넥트 데이터 유형 표에는 각 데이터 유형의 구조와 요구사항을 이해하는 데 도움이 되는 여러 필드 열이 포함되어 있습니다. 이러한 열은 다음과 같습니다.

표: 데이터 유형 필드 설명
필드 설명
예약 레코드 유형 데이터가 특정 시점에 기록되는지 아니면 일정 간격으로 기록되는지 나타냅니다. 가능한 값은 Interval, Instantaneous, Series입니다.
straighten 단위 데이터 유형의 측정 단위입니다 (예: 칼로리, 미터, 개수).
별표 필수 입력란 데이터 무결성과 유용성을 유지하기 위해 이 데이터 유형의 데이터를 작성할 때 포함해야 하는 필수 필드입니다.

건강 및 피트니스 데이터 유형

권한을 요청하기 전에 먼저 앱은 매니페스트에서 권한을 선언해야 합니다. 자세한 내용은 빠른 시작 가이드의 권한 선언 섹션을 참고하세요.

앱이 백그라운드에 있는 동안 데이터를 읽거나 기록 데이터를 읽으려면 데이터 유형 권한과 별도로 추가 읽기 권한 집합을 선언해야 합니다.

표: 헬스 커넥트 데이터 유형의 추가 읽기 권한
추가 읽기 권한 권한 선언
백그라운드에서 데이터 읽기
  백그라운드 읽기 예시 가이드 		android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND
과거 데이터 읽기
  30일이 지난 데이터 읽기 가이드 		android.permission.health.READ_HEALTH_DATA_HISTORY

1. Jetpack 버전 선택

권한 선언은 Jetpack 버전에 따라 다르므로 앱에서 사용하는 Jetpack 버전 범위를 선택해야 합니다.

2. 데이터 유형 표 필터링

다음 표에는 카테고리, 기능 플래그 및 가이드, 권한 선언이 포함된 전체 데이터 유형 목록이 나와 있습니다.

표: 헬스 커넥트 데이터 유형
데이터 유형
  기능 가이드		 카테고리 레코드 유형
권한 선언
기능 플래그
활동 칼로리 소모량

  • 레코드 유형: 인터벌
  • 단위: 에너지

  • 필수 입력란

    endTime
    energy
    metadata
    startTime
활동 ActiveCaloriesBurnedRecord

android.permission.health.READ_ACTIVE_CALORIES_BURNED
android.permission.health.WRITE_ACTIVE_CALORIES_BURNED

집계 데이터 유형

ACTIVE_CALORIES_TOTAL
활동 강도

  • 레코드 유형: 인터벌

  • 필수 입력란

    activityIntensityType
    endTime
    metadata
    startTime
활동 ActivityIntensityRecord

android.permission.health.READ_ACTIVITY_INTENSITY
android.permission.health.WRITE_ACTIVITY_INTENSITY

FEATURE_ACTIVITY_INTENSITY

집계 데이터 유형

DURATION_TOTAL
INTENSITY_MINUTES_TOTAL
MODERATE_DURATION_TOTAL
VIGOROUS_DURATION_TOTAL
기초 체온

  • 레코드 유형: 순간
  • 단위: 온도

  • 필수 입력란

    temperature
    measurementLocation
    metadata
    time
월경 주기 추적 BasalBodyTemperatureRecord

android.permission.health.READ_BASAL_BODY_TEMPERATURE
android.permission.health.WRITE_BASAL_BODY_TEMPERATURE

기초 대사율

  • 레코드 유형: 순간
  • 단위: 전력

  • 필수 입력란

    basalMetabolicRate
    metadata
    time
신체 측정 BasalMetabolicRateRecord

android.permission.health.READ_BASAL_METABOLIC_RATE
android.permission.health.WRITE_BASAL_METABOLIC_RATE

집계 데이터 유형

BASAL_CALORIES_TOTAL
혈당

  • 레코드 유형: 순간

  • 필수 입력란

    level
    specimenSource
    mealType
    relationToMeal
    metadata
    time
Vitals BloodGlucoseRecord

android.permission.health.READ_BLOOD_GLUCOSE
android.permission.health.WRITE_BLOOD_GLUCOSE

혈압

  • 레코드 유형: 순간
  • 단위: 압력

  • 필수 입력란

    systolic
    diastolic
    bodyPosition
    measurementLocation
    metadata
    time
Vitals BloodPressureRecord

android.permission.health.READ_BLOOD_PRESSURE
android.permission.health.WRITE_BLOOD_PRESSURE

집계 데이터 유형

DIASTOLIC_AVG
DIASTOLIC_MAX
DIASTOLIC_MIN
SYSTOLIC_AVG
SYSTOLIC_MAX
SYSTOLIC_MIN
체지방

  • 레코드 유형: 순간

  • 필수 입력란

    percentage
    metadata
    time
신체 측정 BodyFatRecord

android.permission.health.READ_BODY_FAT
android.permission.health.WRITE_BODY_FAT

체온

  • 레코드 유형: 순간
  • 단위: 온도

  • 필수 입력란

    temperature
    measurementLocation
    metadata
    time
Vitals BodyTemperatureRecord

android.permission.health.READ_BODY_TEMPERATURE
android.permission.health.WRITE_BODY_TEMPERATURE

체내 수분량

  • 레코드 유형: 순간
  • 단위: 질량

  • 필수 입력란

    mass
    metadata
    time
신체 측정 BodyWaterMassRecord

android.permission.health.READ_BODY_WATER_MASS
android.permission.health.WRITE_BODY_WATER_MASS

골질량

  • 레코드 유형: 순간
  • 단위: 질량

  • 필수 입력란

    mass
    metadata
    time
신체 측정 BoneMassRecord

android.permission.health.READ_BONE_MASS
android.permission.health.WRITE_BONE_MASS

자궁경관 점액

  • 레코드 유형: 순간

  • 필수 입력란

    appearance
    sensation
    metadata
    time
월경 주기 추적 CervicalMucusRecord

android.permission.health.READ_CERVICAL_MUCUS
android.permission.health.WRITE_CERVICAL_MUCUS

사이클링 페달 회전수

  • 레코드 유형: 시리즈

  • 필수 입력란

    samples
    endTime
    metadata
    samples
    startTime
활동 CyclingPedalingCadenceRecord

android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE

집계 데이터 유형

RPM_AVG
RPM_MAX
RPM_MIN
거리

  • 레코드 유형: 인터벌
  • 단위: 길이

  • 필수 입력란

    distance
    endTime
    metadata
    startTime
활동 DistanceRecord

android.permission.health.READ_DISTANCE
android.permission.health.WRITE_DISTANCE

집계 데이터 유형

DISTANCE_TOTAL
상승 고도

  • 레코드 유형: 인터벌
  • 단위: 길이

  • 필수 입력란

    elevation
    endTime
    metadata
    startTime
활동 ElevationGainedRecord

android.permission.health.READ_ELEVATION_GAINED
android.permission.health.WRITE_ELEVATION_GAINED

집계 데이터 유형

ELEVATION_GAINED_TOTAL
운동

  운동 경로 추가 가이드
  • 레코드 유형: 인터벌

  • 필수 입력란

    exerciseType
    endTime
    laps
    metadata
    segments
    startTime
활동 ExerciseSessionRecord

android.permission.health.READ_EXERCISE
android.permission.health.READ_EXERCISE_ROUTE
android.permission.health.WRITE_EXERCISE
android.permission.health.WRITE_EXERCISE_ROUTE

운동 유형

모든 운동 유형 보기
EXERCISE_TYPE_UNKNOWN
EXERCISE_TYPE_BADMINTON
EXERCISE_TYPE_BASEBALL
EXERCISE_TYPE_BASKETBALL
EXERCISE_TYPE_BIKING
EXERCISE_TYPE_BIKING_STATIONARY
EXERCISE_TYPE_BOOT_CAMP
EXERCISE_TYPE_BOXING
EXERCISE_TYPE_CALISTHENICS
EXERCISE_TYPE_CRICKET
EXERCISE_TYPE_DANCING
EXERCISE_TYPE_ELLIPTICAL
EXERCISE_TYPE_EXERCISE_CLASS
EXERCISE_TYPE_FENCING
EXERCISE_TYPE_FOOTBALL_AMERICAN
EXERCISE_TYPE_FOOTBALL_AUSTRALIAN
EXERCISE_TYPE_FRISBEE_DISC
EXERCISE_TYPE_GOLF
EXERCISE_TYPE_GUIDED_BREATHING
EXERCISE_TYPE_GYMNASTICS
EXERCISE_TYPE_HANDBALL
EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING
EXERCISE_TYPE_HIKING
EXERCISE_TYPE_ICE_HOCKEY
EXERCISE_TYPE_ICE_SKATING
EXERCISE_TYPE_MARTIAL_ARTS
EXERCISE_TYPE_PADDLING
EXERCISE_TYPE_PARAGLIDING
EXERCISE_TYPE_PILATES
EXERCISE_TYPE_RACQUETBALL
EXERCISE_TYPE_ROCK_CLIMBING
EXERCISE_TYPE_ROLLER_HOCKEY
EXERCISE_TYPE_ROWING
EXERCISE_TYPE_ROWING_MACHINE
EXERCISE_TYPE_RUGBY
EXERCISE_TYPE_RUNNING
EXERCISE_TYPE_RUNNING_TREADMILL
EXERCISE_TYPE_SAILING
EXERCISE_TYPE_SCUBA_DIVING
EXERCISE_TYPE_SKATING
EXERCISE_TYPE_SKIING
EXERCISE_TYPE_SNOWBOARDING
EXERCISE_TYPE_SNOWSHOEING
EXERCISE_TYPE_SOCCER
EXERCISE_TYPE_SOFTBALL
EXERCISE_TYPE_SQUASH
EXERCISE_TYPE_STAIR_CLIMBING
EXERCISE_TYPE_STAIR_CLIMBING_MACHINE
EXERCISE_TYPE_STRENGTH_TRAINING
EXERCISE_TYPE_STRETCHING
EXERCISE_TYPE_SURFING
EXERCISE_TYPE_SWIMMING_OPEN_WATER
EXERCISE_TYPE_SWIMMING_POOL
EXERCISE_TYPE_TABLE_TENNIS
EXERCISE_TYPE_TENNIS
EXERCISE_TYPE_VOLLEYBALL
EXERCISE_TYPE_WALKING
EXERCISE_TYPE_WATER_POLO
EXERCISE_TYPE_WEIGHTLIFTING
EXERCISE_TYPE_WHEELCHAIR
EXERCISE_TYPE_OTHER_WORKOUT
EXERCISE_TYPE_YOGA

집계 데이터 유형

EXERCISE_DURATION_TOTAL
오른 계단수

  • 레코드 유형: 인터벌

  • 필수 입력란

    floors
    endTime
    metadata
    startTime
활동 FloorsClimbedRecord

android.permission.health.READ_FLOORS_CLIMBED
android.permission.health.WRITE_FLOORS_CLIMBED

집계 데이터 유형

FLOORS_CLIMBED_TOTAL
심박수

  • 레코드 유형: 시리즈

  • 필수 입력란

    samples
    endTime
    metadata
    startTime
Vitals HeartRateRecord

android.permission.health.READ_HEART_RATE
android.permission.health.WRITE_HEART_RATE

집계 데이터 유형

BPM_AVG
BPM_MAX
BPM_MIN
MEASUREMENTS_COUNT
심박 변이도

  • 레코드 유형: 순간

  • 필수 입력란

    heartRateVariabilityMillis
    metadata
    time
Vitals HeartRateVariabilityRmssdRecord

android.permission.health.READ_HEART_RATE_VARIABILITY
android.permission.health.WRITE_HEART_RATE_VARIABILITY

높이

  • 레코드 유형: 순간
  • 단위: 길이

  • 필수 입력란

    height
    metadata
    time
신체 측정 HeightRecord

android.permission.health.READ_HEIGHT
android.permission.health.WRITE_HEIGHT

집계 데이터 유형

HEIGHT_AVG
HEIGHT_MAX
HEIGHT_MIN
수분 공급

  • 레코드 유형: 인터벌
  • 단위: 볼륨

  • 필수 입력란

    endTime
    metadata
    startTime
    volume
영양 HydrationRecord

android.permission.health.READ_HYDRATION
android.permission.health.WRITE_HYDRATION

집계 데이터 유형

VOLUME_TOTAL
월경간출혈

  • 레코드 유형: 순간

  • 필수 입력란

    metadata
    time
월경 주기 추적 IntermenstrualBleedingRecord

android.permission.health.READ_INTERMENSTRUAL_BLEEDING
android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING

제지방량

  • 레코드 유형: 순간
  • 단위: 질량

  • 필수 입력란

    mass
    metadata
    time
신체 측정 LeanBodyMassRecord

android.permission.health.READ_LEAN_BODY_MASS
android.permission.health.WRITE_LEAN_BODY_MASS

Menstruation


MenstruationFlowRecord의 경우:
  • 레코드 유형: 순간

  • 필수 입력란

    flow
    metadata
    time

MenstruationPeriodRecord의 경우:
  • 레코드 유형: 인터벌

  • 필수 입력란

    endTime
    metadata
    startTime
월경 주기 추적 MenstruationFlowRecord

MenstruationPeriodRecord

android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION


마음챙김

  마음챙김 추적 가이드
  • 레코드 유형: 인터벌

  • 필수 입력란

    endTime
    metadata
    mindfulnessSessionType
    startTime
웰빙 MindfulnessSessionRecord

android.permission.health.READ_MINDFULNESS
android.permission.health.WRITE_MINDFULNESS

FEATURE_MINDFULNESS_SESSION

집계 데이터 유형

MINDFULNESS_DURATION_TOTAL
영양

  • 레코드 유형: 인터벌
  • 단위: 질량

  • 필수 입력란

    endTime
    mealType
    metadata
    startTime
영양 NutritionRecord

android.permission.health.READ_NUTRITION
android.permission.health.WRITE_NUTRITION

집계 데이터 유형

BIOTIN_TOTAL
CAFFEINE_TOTAL
CALCIUM_TOTAL
CHLORIDE_TOTAL
CHOLESTEROL_TOTAL
CHROMIUM_TOTAL
COPPER_TOTAL
DIETARY_FIBER_TOTAL
ENERGY_FROM_FAT_TOTAL
ENERGY_TOTAL
FOLATE_TOTAL
FOLIC_ACID_TOTAL
IODINE_TOTAL
IRON_TOTAL
MAGNESIUM_TOTAL
MANGANESE_TOTAL
MOLYBDENUM_TOTAL
MONOUNSATURATED_FAT_TOTAL
NIACIN_TOTAL
PANTOTHENIC_ACID_TOTAL
PHOSPHORUS_TOTAL
POLYUNSATURATED_FAT_TOTAL
POTASSIUM_TOTAL
PROTEIN_TOTAL
RIBOFLAVIN_TOTAL
SATURATED_FAT_TOTAL
SELENIUM_TOTAL
SODIUM_TOTAL
SUGAR_TOTAL
THIAMIN_TOTAL
TOTAL_CARBOHYDRATE_TOTAL
TOTAL_FAT_TOTAL
TRANS_FAT_TOTAL
UNSATURATED_FAT_TOTAL
VITAMIN_A_TOTAL
VITAMIN_B12_TOTAL
VITAMIN_B6_TOTAL
VITAMIN_C_TOTAL
VITAMIN_D_TOTAL
VITAMIN_E_TOTAL
VITAMIN_K_TOTAL
ZINC_TOTAL
배란 테스트

  • 레코드 유형: 순간

  • 필수 입력란

    metadata
    result
    time
월경 주기 추적 OvulationTestRecord

android.permission.health.READ_OVULATION_TEST
android.permission.health.WRITE_OVULATION_TEST

산소 포화도

  • 레코드 유형: 순간

  • 필수 입력란

    metadata
    percentage
    time
Vitals OxygenSaturationRecord

android.permission.health.READ_OXYGEN_SATURATION
android.permission.health.WRITE_OXYGEN_SATURATION

계획된 운동

  운동 계획 가이드
  • 레코드 유형: 인터벌

  • 필수 입력란

    block
    endTime
    exerciseType
    hasExplicitTime
    metadata
활동 PlannedExerciseSessionRecord

android.permission.health.READ_PLANNED_EXERCISE
android.permission.health.WRITE_PLANNED_EXERCISE

FEATURE_PLANNED_EXERCISE
전원

  • 레코드 유형: 시리즈

  • 필수 입력란

    endTime
    samples
    metadata
    startTime
활동 PowerRecord

android.permission.health.READ_POWER
android.permission.health.WRITE_POWER

집계 데이터 유형

POWER_AVG
POWER_MAX
POWER_MIN
호흡수

  • 레코드 유형: 순간

  • 필수 입력란

    metadata
    rate
    time
Vitals RespiratoryRateRecord

android.permission.health.READ_RESPIRATORY_RATE
android.permission.health.WRITE_RESPIRATORY_RATE

안정 시 심박수

  • 레코드 유형: 순간

  • 필수 입력란

    beatsPerMinute
    metadata
    time
Vitals RestingHeartRateRecord

android.permission.health.READ_RESTING_HEART_RATE
android.permission.health.WRITE_RESTING_HEART_RATE

집계 데이터 유형

BPM_AVG
BPM_MAX
BPM_MIN
성적인 행위

  • 레코드 유형: 순간

  • 필수 입력란

    metadata
    protectionUsed
    time
월경 주기 추적 SexualActivityRecord

android.permission.health.READ_SEXUAL_ACTIVITY
android.permission.health.WRITE_SEXUAL_ACTIVITY

피부 온도

  피부 온도 측정 가이드
  • 레코드 유형: 시리즈
  • 단위: 온도

  • 필수 입력란

    deltas
    endTime
    measurementLocation
    metadata
    startTime
Vitals SkinTemperatureRecord

android.permission.health.READ_SKIN_TEMPERATURE
android.permission.health.WRITE_SKIN_TEMPERATURE

FEATURE_SKIN_TEMPERATURE

집계 데이터 유형

TEMPERATURE_DELTA_AVG
TEMPERATURE_DELTA_MAX
TEMPERATURE_DELTA_MIN
수면 세션

  수면 세션 추적 가이드
  • 레코드 유형: 인터벌

  • 필수 입력란

    endTime
    metadata
    stages
    startTime
절전 모드 SleepSessionRecord

android.permission.health.READ_SLEEP
android.permission.health.WRITE_SLEEP

집계 데이터 유형

SLEEP_DURATION_TOTAL
속도

  • 레코드 유형: 시리즈

  • 필수 입력란

    endTime
    metadata
    samples
    startTime
활동 SpeedRecord

android.permission.health.READ_SPEED
android.permission.health.WRITE_SPEED

집계 데이터 유형

SPEED_AVG
SPEED_MAX
SPEED_MIN
단계


StepsRecord의 경우:
  • 레코드 유형: 인터벌

  • 필수 입력란

    count
    endTime
    metadata
    startTime

StepsCadenceRecord:
  • 레코드 유형: 시리즈

  • 필수 입력란

    endTime
    samples
    metadata
    startTime
활동 StepsRecord

StepsCadenceRecord

android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS

StepsRecord의 집계 데이터 유형

COUNT_TOTAL

StepsCadenceRecord의 집계 데이터 유형

RATE_AVG
RATE_MAX
RATE_MIN
총 칼로리 소모량

  • 레코드 유형: 인터벌
  • 단위: 에너지

  • 필수 입력란

    endTime
    energy
    metadata
    startTime
활동 TotalCaloriesBurnedRecord

android.permission.health.READ_TOTAL_CALORIES_BURNED
android.permission.health.WRITE_TOTAL_CALORIES_BURNED

집계 데이터 유형

ENERGY_TOTAL
최대 산소 소비량

  • 레코드 유형: 순간

  • 필수 입력란

    measurementMethod
    metadata
    time
    vo2MillilitersPerMinuteKilogram
활동 Vo2MaxRecord

android.permission.health.READ_VO2_MAX
android.permission.health.WRITE_VO2_MAX

가중치

  • 레코드 유형: 순간

  • 필수 입력란

    metadata
    time
    weight
신체 측정 WeightRecord

android.permission.health.READ_WEIGHT
android.permission.health.WRITE_WEIGHT

집계 데이터 유형

WEIGHT_AVG
WEIGHT_MAX
WEIGHT_MIN
휠체어 밀기

  • 레코드 유형: 인터벌

  • 필수 입력란

    count
    endTime
    metadata
    startTime
활동 WheelchairPushesRecord

android.permission.health.READ_WHEELCHAIR_PUSHES
android.permission.health.WRITE_WHEELCHAIR_PUSHES

집계 데이터 유형

COUNT_TOTAL