Google Fit — що це, архітектура платформи та API

Що таке Google Fit?

Google Fit — це платформа управління здоров'ям, запущена Google у 2014 році на конференції I/O. Платформа надає єдиний API для читання та запису даних про фізичну активність, дозволяючи додаткам обмінюватися інформацією через центральне сховище в хмарі Google.

На відміну від пропрієтарних рішень, Google Fit працює на операційній системі Android та iOS через REST API. Користувач може підключити фітнес-браслети, розумні годинники та додатки для відстеження активності, а Google Fit агрегує всі дані в єдиний профіль здоров'я в Google Cloud.

За даними Google I/O 2024, платформа використовується в понад 5000 додатках по всьому світу, а кількість активних користувачів перевищує 100 мільйонів. Платформа інтегрована з Wear OS і підтримує всі популярні фітнес-трекери через сторонні додатки.

Архітектура Google Fit

Архітектура Google Fit побудована на трьох рівнях: клієнтський SDK, хмарне сховище Google Fitness Store та REST API для серверної інтеграції. Клієнтський SDK доступний для Android (Kotlin, Java) та iOS (Swift, Objective-C), а також є веб-клієнт через JavaScript.

Дані організовані у вигляді джерел (DataSource) та точок даних (DataPoint). Кожне джерело представляє пристрій або додаток, а кожна точка даних — один вимір з міткою часу. Групи точок даних об'єднуються в сесії — безперервні періоди активності з типом та тривалістю.

val fitnessClient = Fitness.getClient(activity, GoogleSignIn
    .getAccountForExtension(activity, fitnessOptions))

val stepType = DataType.TYPE_STEP_COUNT_DELTA

val request = DataReadRequest.Builder()
    .read(stepType)
    .setTimeRange(
        startTime, endTime, TimeUnit.MILLISECONDS
    )
    .build()

fitnessClient.readData(request)
    .addOnSuccessListener { response ->
        for (bucket in response.buckets) {
            println(bucket.dataSets)
        }
    }

Як працює Google Fit

Google Fit використовує модель синхронізації через Google Cloud з підтримкою як онлайн, так і офлайн-режимів. Додаток записує дані локально, а Google Fit SDK автоматично синхронізує їх з хмарним сховищем за наявності інтернет-з'єднання. Конфлікти вирішуються за принципом останнього запису.

Кожен тип даних має стандартизований формат: кроки — TYPE_STEP_COUNT_DELTA, калорії — TYPE_CALORIES_EXPENDED, пульс — TYPE_HEART_RATE_BPM, відстань — TYPE_DISTANCE_DELTA. Для кастомних типів можна створювати власні DataType через консоль Google APIs з унікальним простором імен.

Платформа підтримує два режими запису: активний — додаток явно викликає HistoryClient.insertData(), і пасивний — через RecordingClient, який підписується на збір даних у фоні. Пасивний режим зручний для фітнес-додатків: користувач запускає додаток один раз, а Google Fit автоматично збирає кроки, калорії та відстань при згорнутому додатку без постійної роботи процесора.

За даними Google, платформа обробляє понад 2 мільярди точок даних щодня. Середня затримка синхронізації становить 5–10 секунд при активному з'єднанні, а в фоновому режимі синхронізація відбувається кожні 30 хвилин для економії заряду батареї.

Згода користувача та безпека

Google Fit використовує OAuth 2.0 для авторизації з областями доступу fitness.activity.read, fitness.activity.write, fitness.body.read та fitness.body.write. Додаток запитує лише необхідні області, а користувач підтверджує доступ через стандартний діалог Google Sign-In з вибором облікового запису.

Користувач може в будь-який момент відкликати доступ через Google Account Permissions або додаток Google Fit. Google суворо забороняє передачу даних про здоров'я третім особам без явної згоди, а також використання даних для рекламних цілей відповідно до політики Restricted Scopes.

API Google Fit

Google Fit надає три основні API: Fitness API для читання та запису історичних даних, Sensors API для потокової передачі даних з датчиків у реальному часі та Sessions API для керування сесіями активності. Кожен API доступний як через Android SDK, так і через REST-запити.

Fitness API — основний API для роботи з даними. Він підтримує пакетні операції: запис до 1000 точок даних за один виклик, читання з фільтрацією за часовим діапазоном, типом даних та джерелом. Для агрегації даних використовується DataSet з групуванням за вибраними метриками.

Sensors API дозволяє підписатися на дані датчиків у реальному часі — кроки, пульс, прискорення. Дані надходять через SensorEventListener з частотою, що визначається типом датчика та налаштуваннями додатка.

Окрім трьох основних API, Google Fit надає Recording API для автоматичного збору даних без необхідності тримати додаток активним. Цей API особливо цінний для Wear OS: розумні годинники можуть збирати дані про пульс та активність, а додаток на телефоні синхронізується з ними при підключенні. Recording API використовує Google Fit Background Services, оптимізовані для мінімального енергоспоживання — до 2% заряду на день при пасивному зборі кроків.

REST API Google Fit доступний через ендпоінт fitness.googleapis.com. REST API дозволяє серверним додаткам читати та записувати дані від імені користувача після OAuth-авторизації. Це корисно для веб-панелей аналітики, корпоративних фітнес-програм та медичних систем, де потрібне централізоване зберігання даних про здоров'я співробітників або пацієнтів.

val recordingClient = Fitness
    .getRecordingClient(activity, googleSignInAccount)

recordingClient.subscribe(DataType.TYPE_STEP_COUNT_DELTA)
    .addOnSuccessListener {
        println("Підписка активна")
    }

// Отримання даних історії
val historyClient = Fitness
    .getHistoryClient(activity, googleSignInAccount)

val endTime = Calendar.getInstance().timeInMillis
val startTime = endTime - TimeUnit
    .DAYS.toMillis(7)

historyClient.readDailyTotal(DataType.TYPE_STEP_COUNT_DELTA)
    .addOnSuccessListener { total ->
        println("Кроків за сьогодні: $total")
    }

Інтеграція Google Fit у додаток

Інтеграція Google Fit починається з підключення залежностей Google Fit SDK через build.gradle: com.google.android.gms:play-services-fitness. Після цього необхідно налаштувати консоль Google APIs — створити проект, увімкнути Fitness API та додати OAuth 2.0 credentials з правильними SHA-1 відбитками.

Процес інтеграції включає: ініціалізацію GoogleSignIn з потрібними скоупами, створення FitnessClient через Fitness.getClient(), запит авторизації у користувача та виконання операцій читання або запису даних. Для фонового запису використовується RecordingClient, який автоматично збирає дані навіть коли додаток згорнуто. Google Fit автоматично керує частотою збору даних залежно від рівня заряду батареї та активності користувача.

За даними Google, додатки з інтеграцією Google Fit показують на 35% вищий рівень утримання користувачів. Ключові категорії додатків — фітнес-трекери, додатки для бігу, велоспорту, йоги та контролю ваги.

Важливо враховувати вимоги до конфіденційності: Google Fit використовує Restricted Scopes — спеціальні області доступу, що вимагають окремої верифікації додатка через OAuth Verification. Розробник повинен описати, які дані збираються, як вони використовуються та як довго зберігаються. Google також вимагає наявність політики конфіденційності та відповідність програмі API Services Terms of Service.

Практичний приклад запису

Для запису даних створюється DataSource із зазначенням типу, пристрою та додатка. Потім формується DataPoint з міткою часу та значеннями. Безліч DataPoint об'єднуються в DataSet, який передається в HistoryClient.write().

val dataSource = DataSource.Builder()
    .setAppPackageName(activity)
    .setDataType(DataType.TYPE_STEP_COUNT_DELTA)
    .setType(DataSource.TYPE_RAW)
    .build()

val stepCount = DataPoint.builder(dataSource)
    .setTimestamp(now, TimeUnit.MILLISECONDS)
    .setField(Field.FIELD_STEPS, 500)
    .build()

val dataSet = DataSet.builder(dataSource)
    .add(stepCount)
    .build()

historyClient.insertData(dataSet)
    .addOnSuccessListener {
        println("Дані збережено")
    }