Интеграция Google Fit для доступа к данным здоровья в Android

Интеграция Google Fit для доступа к данным здоровья в Android

Google Fit API существует с 2014 года и сегодня находится в состоянии «работает, но лучше мигрировать на Health Connect». Google официально рекомендует переходить на Health Connect для новых проектов. Тем не менее, Google Fit остаётся актуальным для устройств на Android 8–13 без поддержки Health Connect, для Wear OS-приложений и для проектов с существующей базой пользователей. Разберём оба подхода.

Google Fit REST API vs Fitness API

Две принципиально разные точки входа:

Android Fitness API (com.google.android.gms:play-services-fitness) — нативный Java/Kotlin SDK, работает через Google Play Services, требует OAuth 2.0-аккаунт Google.

Google Fit REST API — HTTP API, подходит для серверной стороны и Flutter/React Native, но требует собственного управления OAuth токенами.

Для нативного Android — всегда Fitness API. REST имеет смысл только если данные нужны на бэкенде без участия мобильного устройства.

Разрешения и OAuth: главный источник проблем

Google Fit требует двух уровней разрешений:

1. Android-разрешение: android.permission.ACTIVITY_RECOGNITION (с Android 10)
2. OAuth scope: FITNESS_ACTIVITY_READ, FITNESS_BODY_READ, FITNESS_LOCATION_READ и т.д.

Если запросить Android-разрешение, но не получить OAuth scope — Fitness API вернёт пустые данные без ошибки. Это молчаливый сбой, который сложно отловить.

val fitnessOptions = FitnessOptions.builder()
    .addDataType(DataType.TYPE_STEP_COUNT_DELTA, FitnessOptions.ACCESS_READ)
    .addDataType(DataType.TYPE_HEART_RATE_BPM, FitnessOptions.ACCESS_READ)
    .build()

val account = GoogleSignIn.getAccountForExtension(this, fitnessOptions)

if (!GoogleSignIn.hasPermissions(account, fitnessOptions)) {
    GoogleSignIn.requestPermissions(
        this,
        GOOGLE_FIT_REQUEST_CODE,
        account,
        fitnessOptions
    )
}

Если пользователь отзывает разрешение через настройки Google-аккаунта (не через Android Settings), hasPermissions() вернёт false при следующем запуске. Это нужно обрабатывать — без retry-логики приложение просто перестанет получать данные.

Чтение данных: HistoryClient и SensorsClient

Исторические данные (шаги, калории)

val readRequest = DataReadRequest.Builder()
    .read(DataType.TYPE_STEP_COUNT_DELTA)
    .aggregate(DataType.AGGREGATE_STEP_COUNT_DELTA)
    .bucketByTime(1, TimeUnit.DAYS)
    .setTimeRange(startTime, endTime, TimeUnit.MILLISECONDS)
    .build()

Fitness.getHistoryClient(context, account)
    .readData(readRequest)
    .addOnSuccessListener { response ->
        response.buckets.forEach { bucket ->
            val steps = bucket.dataSets
                .flatMap { it.dataPoints }
                .sumOf { it.getValue(Field.FIELD_STEPS).asInt() }
        }
    }

bucketByTime — ключевой метод для агрегации. Без него запрос вернёт каждый отдельный шаг от каждого источника (телефон + часы + браслет), что может быть несколько тысяч записей за день.

Данные в реальном времени

SensorsClient для подписки на живые данные:

Fitness.getSensorsClient(context, account)
    .add(SensorRequest.Builder()
        .setDataType(DataType.TYPE_STEP_COUNT_CUMULATIVE)
        .setSamplingRate(10, TimeUnit.SECONDS)
        .build(),
        onDataPointListener
    )

Этот подписчик активен только пока приложение на переднем плане. Для фонового трекинга — RecordingClient.subscribe(), который Google Fit аккумулирует сам.

Дедупликация данных из нескольких источников

Это реальная боль: у пользователя Apple Watch (через Health) + Google Fit на Android телефоне + Samsung Health — шаги задваиваются и страиваются. Google Fit частично решает это через DataSet.getDataSources() — у каждой точки данных есть источник (DataSource). Фильтрация по DataSource.DEVICE позволяет брать данные только от конкретного устройства.

Полностью надёжной дедупликации нет — это известная проблема экосистемы. Документируем клиенту ожидаемые расхождения и строим UI так, чтобы пользователь мог выбрать приоритетный источник.

Миграция на Health Connect

Для новых устройств (Android 14+) Google Fit deprecated на уровне рекомендаций. Стратегия: проверяем доступность Health Connect, если доступен — используем его, fallback на Google Fit для старых устройств:

val healthConnectAvailable = HealthConnectClient.getSdkStatus(context) ==
    HealthConnectClient.SDK_AVAILABLE

Сроки

Базовая интеграция Google Fit (шаги, дистанция, калории) — 4–7 рабочих дней. С поддержкой Health Connect, дедупликацией и Wear OS — 2–4 недели.