칼로리 및 에너지 데이터 유형

Google Health API는 사용자의 칼로리 및 에너지 소비량을 추적하는 데이터 유형을 제공합니다. 이러한 유형은 총 소모량, 활동 소모량, 안정 시 (기초) 대사율 등 에너지 소모의 다양한 측면을 측정합니다.

이러한 데이터 유형 간의 차이점을 이해하여 애플리케이션에 적합한 측정항목을 확인하세요.

지원되는 데이터 유형

이 API는 칼로리 및 에너지 소비량을 측정하기 위해 다음 데이터 유형을 지원합니다.

표: Google Health API 칼로리 데이터 유형
데이터 유형
  dataType
  filter 매개변수		 Record
type		 사용 가능한
작업		 범위 웹훅
지원		 True zeros
지원
활동 중 소모된 에너지
  active-energy-burned
  active_energy_burned 		간격 list, reconcile, rollup, dailyRollup activity_and_fitness
기초 에너지 소모량
  basal-energy-burned
  basal_energy_burned 		간격 목록, 조정 activity_and_fitness
기초대사율
  basal-metabolic-rate
  basal_metabolic_rate 		샘플 목록, 조정 영양

다음 섹션에서는 REST 표현 예시 및 구체적인 통합 제약 조건을 비롯한 각 데이터 유형의 기술 세부정보를 제공합니다.

총 칼로리

총 칼로리는 기초 대사량과 활동 에너지 등 사용자가 소모한 모든 에너지를 킬로칼로리 (kcal)로 측정하여 추적하는 읽기 전용 파생 데이터 유형입니다. 값은 활동 에너지 소비량과 사용자의 기초 대사율에서 계산됩니다.

활동 에너지 소모량

활동 에너지 소모량은 사용자가 활동하는 동안 소모한 에너지를 나타내며, 기초 에너지 소모량을 제외한 값입니다. 단위는 킬로칼로리(kcal)입니다.

REST 표현 예시

{
  "startTime": "2026-04-20T08:00:00Z",
  "startUtcOffset": "0s",
  "endTime": "2026-04-20T08:30:00Z",
  "endUtcOffset": "0s",
  "dataSource": { ... },
  "kcal": 150.0
}

기초 에너지 소모량

기초 에너지 소모량은 시간 간격 동안 사용자의 휴식 대사로 인해 소모된 칼로리 소모량을 나타내며, 킬로칼로리 (kcal)로 측정됩니다.

참고: 이 데이터 유형에는 롤업 및 일일 롤업 작업을 사용할 수 없습니다. 일일 기초 에너지 값을 가져오려면 기초 대사율 데이터 유형을 사용하세요.

기초대사율

기초 대사율은 정상적인 휴식 상태에서 신체가 소모하는 에너지를 측정하며, 단위는 하루당 킬로칼로리 (kcal/day)입니다. 이 비율은 시간이 지남에 따라 신체 업데이트 (예: 체중)에 따라 변동되므로 API는 BMR을 비율 샘플의 시계열로 기록합니다.

개발자는 basal-metabolic-rate 샘플의 rateKcalPerDay 필드를 소모된 기초 에너지의 일일 롤업에 상응하는 일일 값으로 취급할 수 있습니다.

REST 표현 예시

{
  "date": {
    "year": 2026,
    "month": 4,
    "day": 20
  },
  "dataSource": { ... },
  "rateKcalPerDay": 1650.0
}

가이드라인

앱에 칼로리 및 에너지 측정항목을 통합할 때는 다음 가이드라인을 따르세요.

  • 일일 개요: 전체 일일 칼로리 소모량을 표시하려면 total-calories 데이터 유형의 일일 롤업을 요청하세요.
  • 활동 전용 소모량: 특정 운동 중 또는 안정 시 대사율을 제외한 하루 종일 소모된 칼로리를 추적하려면 active-energy-burned를 쿼리하세요.
  • 기초 측정항목: 휴식 시 대사율 또는 기초 대사율 추세를 추적하려면 basal-metabolic-rate에 BMR 값을 쿼리하세요. BMR 샘플을 사용자의 휴식 시 에너지 소비량의 일일 기준선으로 취급하세요.
이전
데이터 유형 색인