Google Health API 데이터 유형

다음 표에는 데이터 유형의 전체 목록이 나와 있으며, Google Health API에서 각 유형의 표현과 각 유형이 제공되는 범위를 이해하는 데 도움이 되는 여러 열이 있습니다.

중요: 데이터 유형에 단어가 두 개 이상 있는 경우 데이터 유형 식별자의 형식이 다릅니다. 엔드포인트에서 데이터 유형 이름은 body-fat와 같은 케밥 케이스여야 합니다. 하지만 필터 매개변수에서는 데이터 유형 이름이 body_fat와 같은 스네이크 케이스여야 합니다.

표: Google Health API 데이터 유형

데이터 유형   dataType   filter 매개변수	Record type	사용 가능한 작업	범위	웹훅 지원	True zeros 지원
활동 중 소모된 에너지   active-energy-burned   active_energy_burned	간격	list, reconcile, rollup, dailyRollup	activity_and_fitness
활동 시간(분)   active-minutes   active_minutes	간격	list, reconcile, rollup, dailyRollup	activity_and_fitness
액티브존 미닛   active-zone-minutes   active_zone_minutes	간격	list, reconcile, rollup, dailyRollup	activity_and_fitness
활동 수준   activity-level   activity_level	간격	목록, 조정	activity_and_fitness
고도   altitude   altitude	간격	list, reconcile, rollup, dailyRollup	activity_and_fitness
혈당   blood-glucose   blood_glucose	샘플	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
체지방   body-fat   body_fat	샘플	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements
심박수 구간에서 소모된 칼로리   calories-in-heart-rate-zone   calories_in_heart_rate_zone	간격	rollup, dailyRollup	activity_and_fitness
핵심 체온   core-body-temperature   core_body_temperature	샘플	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
일일 심박 변이도   daily-heart-rate-variability   daily_heart_rate_variability	매일	목록, 조정	health_metrics_and_measurements
일일 심박수 구간   daily-heart-rate-zones   daily_heart_rate_zones	매일	목록, 조정	health_metrics_and_measurements
일일 산소 포화도   daily-oxygen-saturation   daily_oxygen_saturation	매일	목록, 조정	health_metrics_and_measurements
일일 호흡수   daily-respiratory-rate   daily_respiratory_rate	매일	목록, 조정	health_metrics_and_measurements
일일 안정 시 심박수   daily-resting-heart-rate   daily_resting_heart_rate	매일	목록, 조정	health_metrics_and_measurements
일일 수면 온도 파생   daily-sleep-temperature-derivations   daily_sleep_temperature_derivations	매일	목록, 조정	health_metrics_and_measurements
일일 최대 산소 섭취량   daily-vo2-max   daily_vo2_max	매일	목록, 조정	activity_and_fitness
거리   distance   distance	간격	list, reconcile, rollup, dailyRollup	activity_and_fitness
심전도 (ECG)   electrocardiogram   electrocardiogram	세션	list	ecg
운동   exercise   exercise	세션	list, get, reconcile, create, update, batchDelete	activity_and_fitness
층수   floors   floors	간격	조정, 롤업, dailyRollup	activity_and_fitness
음식   food   food	음식	list, get	영양
음식 측정 단위   food-measurement-unit   food_measurement_unit	음식	list, get	영양
심박수   heart-rate   heart_rate	샘플	list, reconcile, rollup, dailyRollup	health_metrics_and_measurements
심박 변이도   heart-rate-variability   heart_rate_variability	샘플	목록, 조정	health_metrics_and_measurements
높이   height   height	샘플	list, get, reconcile, create, update, batchDelete	health_metrics_and_measurements
수분 섭취 기록   hydration-log   hydration_log	세션	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	영양
불규칙한 심장 리듬 알림   irregular-rhythm-notification   irregular_rhythm_notification	세션	list	irn
영양 기록   nutrition-log   nutrition_log	샘플	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	영양
산소 포화도   oxygen-saturation   oxygen_saturation	샘플	목록, 조정	health_metrics_and_measurements
호흡수 수면 요약   respiratory-rate-sleep-summary   respiratory_rate_sleep_summary	샘플	목록, 조정	health_metrics_and_measurements
러닝 최대 산소 섭취량   run-vo2-max   run_vo2_max	샘플	list, reconcile, rollup, dailyRollup	activity_and_fitness
무활동 기간   sedentary-period   sedentary_period	간격	list, reconcile, rollup, dailyRollup	activity_and_fitness
절전 모드   sleep   sleep	세션	list, get, reconcile, create, update, batchDelete	sleep
단계   steps   steps	간격	list, reconcile, rollup, dailyRollup	activity_and_fitness
수영 거리 데이터   swim-lengths-data   swim_lengths_data	간격	list, reconcile, rollup, dailyRollup	activity_and_fitness
심박수 구간별 시간   time-in-heart-rate-zone   time_in_heart_rate_zone	간격	list, reconcile, rollup, dailyRollup	activity_and_fitness
총 칼로리   total-calories   total_calories	간격	rollup, dailyRollup	activity_and_fitness
최대 산소 섭취량   vo2-max   vo2_max	샘플	목록, 조정	activity_and_fitness
가중치   weight   weight	샘플	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements

데이터 사용 가능 여부

사용자가 활동 추적기를 동기화하거나 Fitbit 모바일 또는 웹 앱에 새 데이터를 수동으로 입력한 후에만 사용자 데이터를 업데이트할 수 있습니다. Fitbit 앱이 모바일 기기에서 열려 있고 Fitbit 기기와 Fitbit 모바일 앱이 활성 데이터 연결을 사용하며 블루투스 범위 내에 있는 경우 15분마다 자동으로 동기화할 수 있습니다. 사용자가 MobileTrack을 사용하여 활동을 모니터링하는 경우 앱이 열려 있는 동안 MobileTrack이 매시간 동기화됩니다.

서드 파티 액세스

Fitbit 기기는 서드 파티 애플리케이션 또는 서비스와 직접 통신할 수 없습니다. 이러한 기기는 Fitbit 모바일 앱과만 통신하고 동기화하도록 설계되었습니다.

Fitbit 앱이 열려 있을 때 또는 블루투스가 활성화되어 있고 앱이 백그라운드에서 실행 중인 경우 15분마다 기기가 하루 종일 데이터를 자동으로 동기화합니다. 이 동기화 프로세스가 완료되면 Google Health API를 통해 서드 파티 서비스에서 데이터를 사용할 수 있습니다.

거리 표준

elevationGainMillimeters와 같은 운동 거리는 다음과 같은 이유로 밀리미터를 표준 단위로 측정합니다.

1. 데이터 정밀도 유지: 밀리미터를 사용하는 가장 중요한 이유는 읽고 제공하는 데이터의 정밀도를 유지하기 위해서입니다. 밀리미터와 같은 세부적인 단위를 사용하면 측정값을 높은 정확도로 나타낼 수 있습니다.
2. 표준화: 밀리미터는 Google 서비스 전반에서 설계된 표준화된 단위입니다. 이러한 일관성은 API의 여러 부분과 상호작용하는 개발자에게 균일한 환경을 제공하는 데 도움이 됩니다.
3. 광범위한 측정 시스템 지원: 밀리미터와 같은 기본 단위를 사용하면 개발자가 미터법, 영국식 또는 기타 측정 시스템을 사용하는지 여부에 관계없이 선택한 다른 단위로 쉽게 변환할 수 있습니다.

다양한 낮 길이

Health API의 시간 처리에서는 일광 절약 시간제 또는 여행으로 인해 달라지는 하루 길이를 고려하여 사용자의 시간을 우선시합니다. 모든 데이터 포인트는 실제 UTC 타임스탬프와 이벤트 발생 시 활성화된 UTC 오프셋을 모두 사용하여 저장됩니다. 이를 통해 시스템은 다음 작업을 할 수 있습니다.

• 이벤트를 정확한 물리적 순간에 매핑합니다.
• 집계를 위해 시간을 사용자의 현지 컨텍스트로 수정합니다.

일광절약시간

일광 절약 시간이 적용되면 '폴백'으로 인해 25시간의 민간 날짜가 발생하며 해당 날짜의 롤업에는 25시간의 데이터가 포함됩니다. '서머타임'은 시간이 표준 시간대로 돌아가는 23시간의 민간 날짜를 초래합니다.

여행

시간대를 이동하면 단일 민간 날짜의 실제 기간이 훨씬 더 크게 달라질 수 있습니다.

dailyRollUp 엔드포인트를 사용하여 시간대 차이를 조정합니다. 사용자의 현지 시간에 따라 기록된 날짜의 캘린더 날짜에 데이터를 자동으로 귀속시켜 시간대 이동에도 불구하고 날짜를 효과적으로 '연결'합니다.