이전 가이드

Google 피트니스 API는 2026년에 지원 중단됩니다. Google은 사용자가 지원 중단 후에도 목표를 달성할 수 있도록 다양한 건강 및 웰빙 제품과 서비스를 제공합니다.

다음 가이드라인은 Google 피트니스 Android API를 사용하는 방식에 따라 어느 서비스로 이전해야 하는지 보여줍니다.

이 페이지는 최신 정보와 가이드로 계속 업데이트됩니다.

Fit API 통합

하나 이상의 Fit API를 사용하지만 UI에 Fit 앱으로 연결되는 직접 링크를 포함하지 않는 경우 이 가이드라인을 참고하세요. UI에 피트니스를 표시하는 경우 피트니스 앱 통합 가이드라인을 참고하세요.

Fit Recording API를 사용하여 걸음 수를 기록하는 앱

Fit Recording API를 사용하면 앱에서 구독을 만들어 배터리 효율적인 방식으로 센서 데이터를 자동으로 저장하도록 요청할 수 있습니다. 각 구독은 Android 앱을 특정 피트니스 데이터 유형 또는 데이터 소스에 연결하며 Step 데이터 유형은 일반적으로 걸음 수 기록에 사용됩니다.

피트니스 녹음 API에서 이전하려면 다음 단계를 따르세요.

표 1: 피트니스 기록 API에서 이전하는 단계

휴대전화	Wear
앱에서 로컬 걸음 수 데이터를 계속 표시하려면 모바일의 Recording API를 사용하여 데이터 캡처를 구현하세요. 다른 앱과 기기의 집계된 걸음 수를 포함한 총 걸음 수를 표시하려면 앱에 헬스 커넥트를 추가하세요.	건강 관리 서비스 사용: PassiveMonitoringClient ExerciseClient 두 API의 차이점에 관한 자세한 내용은 건강 관리 서비스 문서를 참고하세요.

History API를 사용하여 피트니스 저장소에서 데이터를 읽거나 쓰는 앱

History API를 사용하면 앱이 피트니스 저장소에서 일괄 작업을 실행할 수 있습니다. 이러한 작업에는 이전의 건강 및 웰빙 데이터를 읽고 삽입하고 업데이트하고 삭제하는 작업이 포함됩니다.

History API에서 이전하려면 다음 단계를 따르세요.

표 2: Fit History API에서 이전하는 단계

휴대전화	Wear
앱에 헬스 커넥트 추가	적용할 수 없습니다. 웨어러블 기기가 아닌 모바일 앱에서 헬스 커넥트를 사용합니다.

Sensor API를 사용하여 실시간 피트니스 데이터를 표시하는 앱

Sensor API를 사용하면 앱에서 실시간으로 원시 센서 데이터를 읽을 수 있습니다. Sensor API는 다음 작업을 실행합니다.

• 기기 및 호환 기기에서 사용할 수 있는 데이터 소스를 나열합니다.
• 원시 센서 데이터를 수신하도록 리스너를 등록합니다.
• 더 이상 원시 센서 데이터를 수신하지 않도록 리스너 등록을 취소합니다.

Sensor API에서 이전하려면 다음 단계를 따르세요.

표 3: Fit 센서 API에서 이전하는 단계

휴대전화	Wear
센서, 통합 위치 정보 제공자 API 사용	Wear OS에서 건강 관리 서비스 사용: PassiveMonitoringClient MeasureClient ExerciseClient 또는 SensorManager, FusedLocationProvider 사용

세션 API를 사용하여 활동 요약을 제공하는 앱

세션은 사용자가 피트니스 활동을 하는 동안의 시간 인터벌을 나타냅니다.

Session API를 사용하면 앱에서 피트니스 저장소에 세션을 만들 수 있습니다.

Session API에서 이전하려면 다음 단계를 따르세요.

표 4: Fit Session API에서 이전하는 단계

휴대전화	Wear
시작/중지: 관련 없음. 애플리케이션은 내부적으로 진행 중인 세션의 상태를 추적해야 합니다. 읽기/쓰기: 앱에 헬스 커넥트 추가	시작/중지: 건강 관리 서비스(ExerciseClient) 사용 읽기/쓰기: 모바일 앱으로 헬스 커넥트를 사용합니다. 특정 워크플로의 경우 다음을 권장합니다. 세션 삽입: 개발자는 모바일 앱과 함께 헬스 커넥트를 사용하고 그에 따라 ExerciseSessionRecord 또는 SleepSessionRecord을 삽입해야 합니다.

Goals API를 사용하는 앱

목표는 사용자가 걸음 수, 심장 강화 점수와 같은 측정항목에 대해 설정할 수 있는 Google 피트니스 앱의 타겟입니다. 피트니스 플랫폼은 Goals API를 사용하여 목표를 기록하고 목표와 관련된 일별 활동을 추적합니다.

표 5: Fit Goals API 이전 안내

휴대전화	Wear
사용할 수 있는 대체 API가 없습니다.	사용할 수 있는 대체 API가 없습니다.

BLE API를 사용하는 앱

앱에서 BLE API를 사용하여 사용 가능한 저전력 블루투스 (BLE) 기기를 찾아 Google 피트니스 플랫폼에 센서 데이터를 삽입할 수 있습니다.

BLE API에서 이전하려면 다음 단계를 따르세요.

표 6: Fit BLE API에서 이전하는 단계

휴대전화	Wear
Android Bluetooth API를 직접 사용합니다.	Android Bluetooth API를 직접 사용합니다.

피트니스 앱 통합

다음은 앱의 기존 사용자 또는 신규 사용자가 있는지에 따라 Fit 앱을 통합하는 방법을 보여줍니다.

앱의 기존 사용자

앱 UI에 사용자가 Google 피트니스에 연결할 수 있는 방법이 포함되어 있거나 앱이 Google 피트니스와 호환되는 앱 목록에 포함되어 있는 경우 현재 사용자를 위해 피트니스 앱 통합을 계속 유지할 수 있습니다.

Fit 앱 통합을 지원 중단해야 하는 시점과 사용자 환경을 유지하기 위한 최적의 옵션에 관한 정보는 이 섹션에서 계속 업데이트됩니다. 그동안 Google에 문의해 주세요.

표 7: 피트니스 앱 통합을 사용하는 기존 사용자를 위한 권장사항

확인권장사항:	닫기이렇게 하지 마세요
앱에서 헬스 커넥트를 새로운 옵션으로 제공합니다. 풍부한 데이터와 통계, 개인 정보 보호, 보안과 같은 사용자 이점에 집중하세요.	사용자에게 Google 피트니스 연결을 해제하도록 요청합니다.

앱의 신규 사용자

앱의 신규 사용자에게 유사한 환경을 제공하려면 헬스 커넥트 통합을 빌드하는 것이 좋습니다.

헬스 커넥트를 사용하면 새로운 데이터 소스와 유형에 액세스하여 사용자에게 더 풍부한 환경을 제공할 수 있습니다. 데이터는 기기에 저장되며 사용자가 허용한 앱 간에 안전하게 공유되므로 비공개로 안전하게 유지됩니다.

표 8: Fit 앱 통합을 사용하는 신규 사용자를 위한 권장사항

확인권장사항:	닫기이렇게 하지 마세요
앱의 설정 흐름에 헬스 커넥트를 포함합니다.	헬스 커넥트가 제공되면 사용자가 연결할 수 있는 앱으로 피트를 제공합니다.