Google Health API는 steps 간격 데이터 유형을 사용하여 사용자 걸음 수 및 활동 데이터를 추적합니다. 걸음 수에는 일일 신체 활동의 기본 측정항목이 표시되므로 개발자는 이를 통해 운동 진행 상황을 추적하고, 에너지 소비량을 계산하고, 사용자에게 표시되는 일일 활동 요약을 작성할 수 있습니다.
사용자에게 최고의 환경을 제공하기 위해 애플리케이션에서 걸음 수 측정항목을 읽고 구성하는 방법을 알아보세요.
지원되는 데이터 유형
API는 걸음 수 추적을 위해 다음 데이터 유형을 지원합니다.
데이터 유형dataType
filter 매개변수 |
레코드 유형 |
사용 가능한 작업 |
범위 | 웹훅 지원 |
True zeros 지원 |
|---|---|---|---|---|---|
걸음 수
stepssteps
|
인터벌 | list, reconcile, rollup, dailyRollup | .activity_and_fitness.readonly.activity_and_fitness.writeonly |
다음 섹션에서는 REST 표현 예시 및 통합 가이드라인을 비롯한 steps 데이터 유형의 기술 세부정보를 제공합니다.
필수 범위
이 데이터 유형에 액세스하려면 앱에서 다음 OAuth 범위를 요청해야 합니다.
- 읽기:
https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly - 쓰기:
https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly
가이드라인
앱에 걸음 수 추적을 통합할 때는 다음 설계 및 구현 가이드라인을 따르세요.
일일 개요
여행, 시간대 변경 또는 일광 절약 시간으로 인해 일일 걸음 수를 정확하게 집계하려면 클라이언트 측 기간 계산을 실행하지 마세요. 대신 UTC 오프셋을 사용하여 신체 데이터 격차를 자동으로 조정하는 dailyRollUp 엔드포인트를 쿼리합니다. 롤업은 요청된 날짜의 누적된 총 걸음 수를 나타내는 countSum 필드가 포함된 StepsRollupValue를 반환합니다.
사용자 인터페이스 그리기 (조정)
걸음 수 데이터를 표시하는 사용자 인터페이스 요소를 빌드할 때는 reconcile 엔드포인트를 사용합니다. 스마트워치 및 휴대전화와 같은 여러 데이터 소스에서 동시에 걸음 수를 기록한 경우 reconcile 엔드포인트는 충돌을 해결하고 스트림을 병합하여 조정된 단일 데이터 스트림을 반환합니다.
일중 추적 및 히스토그램
차트 및 그래프와 같이 하루 종일의 상세한 사용자 활동을 표시하려면 다음 단계를 따르세요.
- 시간별 걸음 수 히스토그램:
windowSize매개변수를 사용하여 기간 (예: 1시간의 경우3600s)을 지정하여rollUp엔드포인트를 쿼리합니다. - 모든 걸음 수 기록:
list엔드포인트를 사용하여 가장 세분화된 원시 걸음 수 기록을 가져옵니다.
rollUp 및 reconcile 엔드포인트는 모두 dataSourceFamily 쿼리 매개변수를 허용하므로 특정 소스 그룹의 데이터를 필터링할 수 있습니다.
웹훅을 사용한 실시간 동기화
새 걸음 수 데이터가 가져오거나 동기화될 때 실시간으로 알림을 받으려면 steps 데이터 유형 컬렉션을 구독하세요. REST 엔드포인트를 폴링하는 대신 이러한 웹훅 알림에 따라 클라이언트 측 대시보드를 동적으로 업데이트합니다. 구독을 설정하는 방법에 관한 자세한 내용은
웹훅 구독을 참고하세요.
True zeros 처리
Google Health API는 True zeros를 구현하여 앉아 있는 간격을 해결합니다. 사용자가 활동 중이거나 트래커를 착용하고 있지만 걷지 않는 경우 트래커는
명시적 걸음 수 간격을 count "0" 씁니다. 이를 통해 사용자가 기기를 착용한 상태에서 걸음 수가 0인 기간과 기기를 전혀 착용하지 않은 기간을 구분할 수 있습니다. 자세한 내용은
데이터 존재 및 True zeros 가이드를
참고하세요.