Google Health API는 steps 간격 데이터 유형을 사용하여 사용자 걸음 수와 활동 데이터를 추적합니다. 걸음 수는 일일 신체 활동의 기본 측정값으로, 개발자가 피트니스 진행 상황을 추적하고 에너지 소모량을 계산하며 사용자 대상 일일 활동 요약을 작성하는 데 도움이 됩니다.
사용자에게 최상의 환경을 제공하기 위해 애플리케이션에서 걸음 수 측정항목을 읽고 구조화하는 방법을 이해합니다.
지원되는 데이터 유형
API는 걸음 수 추적을 위해 다음 데이터 유형을 지원합니다.
| 데이터 유형 | 사용 가능한 작업 |
범위 |
|---|---|---|
|
단계
dataType:
stepsfilter parameter: steps
레코드 유형: 인터벌
스토리지 해상도: 1분
호환 기기
|
list, reconcile, rollup, dailyRollup | .activity_and_fitness.readonly.activity_and_fitness.writeonly |
가이드라인
걸음 수 추적을 앱에 통합할 때는 다음 디자인 및 구현 가이드라인을 따르세요.
속도 및 페이스 계산
Google Health API는 표준 공식을 사용하여 속도와 페이스를 계산합니다.
- 속도 =
distance / time(hour) - 페이스 =
time(seconds) / distance
요청에 지정된 Accept-Language 헤더에 따라 거리 단위가 결정됩니다.
일일 개요
여행, 시간대 변경 또는 일광 절약 시간제에서 일일 걸음 수를 정확하게 집계하려면 클라이언트 측 기간 계산을 실행하지 마세요. 대신 UTC 오프셋을 사용하여 신체 데이터 격차를 자동으로 조정하는 dailyRollUp 엔드포인트를 쿼리하세요. 롤업은 요청된 날짜의 누적 총 걸음 수를 나타내는 countSum 필드가 포함된 StepsRollupValue를 반환합니다. 자세한 내용은 합산 데이터 가이드의 달력 일수 전체 집계를 참고하세요.
사용자 인터페이스 그리기 (재구성)
걸음 수 데이터를 표시하는 사용자 인터페이스 요소를 빌드할 때는 reconcile 엔드포인트를 사용하세요. 여러 데이터 소스 (예: 스마트시계 및 휴대전화)가 동시에 걸음 수를 기록한 경우 reconcile 엔드포인트는 충돌을 해결하고 스트림을 병합하여 조정된 단일 데이터 스트림을 반환합니다.
연결된 기기 동기화 및 타임스탬프 변경 가능성으로 인한 중복 간격 처리에 관한 자세한 내용은 데이터 관리 가이드를 참고하세요.
일중 추적 및 히스토그램
하루 동안의 세부적인 사용자 활동(예: 차트 및 그래프)을 표시하려면 다음 안내를 따르세요.
- 시간 또는 분 단위 히스토그램:
windowSize매개변수를 사용하여 기간 (예: 1분의 경우60s, 1시간의 경우3600s)을 지정하여rollUp엔드포인트를 쿼리합니다. 걸음 수 데이터는 1분(60s) 간격으로 기록되므로windowSize를60s이상으로 설정합니다. 1분 미만의 기간 크기 (예:10s또는30s)가 있는 요청은 개별 분 합계를 분할하지 않고 전체 분 수를 일치하는 첫 번째 하위 버킷에 배치합니다. 자세한 내용은 롤업 기간 및 스토리지 해상도를 참조하세요. - 모든 걸음 수 기록:
list엔드포인트를 사용하여 가장 세분화된 원시 걸음 수 기록을 가져옵니다.
rollUp, dailyRollUp, reconcile 엔드포인트는 dataSourceFamily 매개변수를 허용하므로 특정 소스 그룹의 데이터를 필터링할 수 있습니다. 자세한 내용과 사용 예시는 데이터 필터링 가이드의 데이터 소스 계열별 필터링 섹션을 참조하세요.
웹훅을 사용한 실시간 동기화
steps 데이터 유형 컬렉션을 구독하여 새 걸음 수 데이터가 가져오기되거나 동기화될 때 실시간으로 알림을 받습니다. REST 엔드포인트를 폴링하는 대신 이러한 웹훅 알림에 대한 응답으로 클라이언트 측 대시보드를 동적으로 업데이트합니다. 구독을 설정하는 방법에 대한 자세한 내용은 웹훅 구독을 참조하세요.