이전 가이드

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

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

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

Fit API 통합

Fit API를 하나 이상 사용하지만 UI에 Fit 앱에 대한 직접 링크를 포함하지 않는 경우 이 가이드라인을 참고하세요. UI에 Fit을 표시하는 경우 Fit 앱 통합 가이드라인을 참고하세요.

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

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

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

휴대전화 Wear
  1. 앱에서 로컬 걸음 수 데이터를 계속 표시하려면 모바일의 녹화 API를 사용하여 데이터 캡처를 구현하세요.
  2. 다른 앱 및 기기의 집계된 걸음 수 시스템을 포함한 총 걸음 수를 표시하려면 앱에 헬스 커넥트를 추가하세요.

건강 관리 서비스 사용:

  • PassiveMonitoringClient
  • ExerciseClient

두 가지의 차이점에 관한 자세한 내용은 건강 관리 서비스 문서를 참고하세요.

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

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

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

휴대전화 Wear

앱에 헬스 커넥트 추가

해당하지 않습니다. 웨어러블 기기가 아닌 모바일 앱에서 헬스 커넥트를 사용합니다.

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

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

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

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

휴대전화 Wear

센서, Fused Location Provider API 사용

Wear OS에서 건강 관리 서비스를 사용합니다.

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    또는 SensorManager, FusedLocationProvider를 사용합니다.

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

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

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

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

휴대전화 Wear

시작/중지: 관련 없음. 애플리케이션은 내부적으로 진행 중인 세션의 상태를 추적해야 합니다.

읽기/쓰기: 앱에 헬스 커넥트 추가

시작/중지: 건강 관리 서비스(ExerciseClient) 사용

읽기/쓰기: 모바일 앱에서 헬스 커넥트를 사용합니다.

특정 워크플로의 경우 다음을 권장합니다.

  • 세션 삽입: 개발자는 모바일 앱에서 헬스 커넥트를 사용하고 그에 따라 ExerciseSessionRecord 또는 SleepSessionRecord를 삽입해야 합니다.

Goals API를 사용하는 앱

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

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

BLE API를 사용하는 앱

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

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

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

Fit 앱 통합

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

앱의 기존 사용자

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

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

확인실행 닫기금지사항
앱에서 새로운 옵션으로 헬스 커넥트를 제공합니다.

더 풍부한 데이터 및 통계, 개인 정보 보호, 보안과 같은 사용자 혜택에 중점을 둡니다.

헬스 커넥트와 동기화

사용자에게 Google 피트니스 연결을 해제하도록 요청합니다.

헬스 커넥트 연결 해제

앱의 신규 사용자

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

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

확인실행 닫기금지사항
앱의 설정 흐름에 헬스 커넥트를 포함합니다. 헬스 커넥트를 사용할 수 있게 되면 사용자가 연결할 수 있는 앱으로 Fit을 제공합니다.