Google Fit — qu’est-ce que c’est, architecture de la plateforme et API

Qu’est-ce que Google Fit ?

Google Fit est une plateforme de gestion de la santé lancée par Google en 2014 lors de la conférence I/O. La plateforme fournit une API unifiée pour lire et écrire des données d’activité physique, permettant aux applications d’échanger des informations via un référentiel central dans le cloud Google.

Contrairement aux solutions propriétaires, Google Fit fonctionne sur le système d’exploitation Android et iOS via REST API. Les utilisateurs peuvent connecter des bracelets de fitness, des montres connectées et des applications de suivi d’activité, et Google Fit agrège toutes les données dans un profil de santé unique dans Google Cloud.

Selon Google I/O 2024, la plateforme est utilisée dans plus de 5000 applications dans le monde, et le nombre d’utilisateurs actifs dépasse les 100 millions. La plateforme est intégrée à Wear OS et prend en charge tous les trackers de fitness populaires via des applications tierces.

Architecture de Google Fit

L’architecture de Google Fit repose sur trois couches : SDK client, stockage cloud Google Fitness Store et REST API pour l’intégration serveur. Le SDK client est disponible pour Android (Kotlin, Java) et iOS (Swift, Objective-C), et il existe également un client web via JavaScript.

Les données sont organisées sous forme de sources (DataSource) et de points de données (DataPoint). Chaque source représente un appareil ou une application, et chaque point de données représente une seule mesure avec un horodatage. Des groupes de points de données sont combinés en sessions — des périodes continues d’activité avec un type et une durée.

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)
        }
    }

Comment fonctionne Google Fit

Google Fit utilise un modèle de synchronisation via Google Cloud avec prise en charge des modes en ligne et hors ligne. L’application enregistre les données localement, et le SDK Google Fit les synchronise automatiquement avec le stockage cloud lorsqu’une connexion Internet est disponible. Les conflits sont résolus selon le principe de la dernière écriture.

Chaque type de donnée a un format standardisé : pas — TYPE_STEP_COUNT_DELTA, calories — TYPE_CALORIES_EXPENDED, fréquence cardiaque — TYPE_HEART_RATE_BPM, distance — TYPE_DISTANCE_DELTA. Pour les types personnalisés, vous pouvez créer des DataType personnalisés via la console Google APIs avec un espace de noms unique.

La plateforme prend en charge deux modes d’enregistrement : actif — l’application appelle explicitement HistoryClient.insertData(), et passif — via RecordingClient, qui s’abonne à la collecte de données en arrière-plan. Le mode passif est pratique pour les applications de fitness : l’utilisateur lance l’application une fois, et Google Fit collecte automatiquement les pas, calories et distance pendant que l’application est minimisée, sans utilisation constante du processeur.

Selon Google, la plateforme traite plus de 2 milliards de points de données chaque jour. La latence moyenne de synchronisation est de 5 à 10 secondes avec une connexion active, et en mode arrière-plan, la synchronisation a lieu toutes les 30 minutes pour économiser la batterie.

Consentement de l’utilisateur et sécurité

Google Fit utilise OAuth 2.0 pour l’autorisation avec les portées d’accès fitness.activity.read, fitness.activity.write, fitness.body.read et fitness.body.write. L’application demande uniquement les portées nécessaires, et l’utilisateur confirme l’accès via la boîte de dialogue standard Google Sign-In avec sélection de compte.

L’utilisateur peut révoquer l’accès à tout moment via Google Account Permissions ou l’application Google Fit. Google interdit strictement le partage de données de santé avec des tiers sans consentement explicite, ainsi que l’utilisation des données à des fins publicitaires conformément à la politique Restricted Scopes.

API Google Fit

Google Fit fournit trois API principales : Fitness API pour lire et écrire des données historiques, Sensors API pour le streaming en temps réel des données des capteurs, et Sessions API pour gérer les sessions d’activité. Chaque API est disponible via le SDK Android et via des requêtes REST.

Fitness API est l’API principale pour travailler avec les données. Elle prend en charge les opérations par lots : écriture jusqu’à 1000 points de données en un seul appel, lecture avec filtrage par plage de temps, type de données et source. Pour l’agrégation des données, DataSet est utilisé avec regroupement par métriques sélectionnées.

Sensors API permet de s’abonner aux données des capteurs en temps réel — pas, fréquence cardiaque, accélération. Les données sont reçues via SensorEventListener à une fréquence déterminée par le type de capteur et les paramètres de l’application.

En plus des trois API principales, Google Fit fournit Recording API pour la collecte automatique de données sans avoir besoin de maintenir l’application active. Cette API est particulièrement précieuse pour Wear OS : les montres connectées peuvent collecter des données de fréquence cardiaque et d’activité, et l’application téléphone se synchronise avec elles lors de la connexion. Recording API utilise Google Fit Background Services, optimisés pour une consommation d’énergie minimale — jusqu’à 2% de batterie par jour avec une collecte passive de pas.

REST API de Google Fit est disponible au point d’accès fitness.googleapis.com. REST API permet aux applications serveur de lire et d’écrire des données au nom de l’utilisateur après autorisation OAuth. Ceci est utile pour les tableaux de bord d’analyse web, les programmes de fitness d’entreprise et les systèmes médicaux nécessitant un stockage centralisé des données de santé des employés ou des patients.

val recordingClient = Fitness
    .getRecordingClient(activity, googleSignInAccount)

recordingClient.subscribe(DataType.TYPE_STEP_COUNT_DELTA)
    .addOnSuccessListener {
        println("Abonnement actif")
    }

// Obtention des données d’historique
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("Pas aujourd’hui : $total")
    }

Intégration de Google Fit dans une application

L’intégration de Google Fit commence par l’ajout des dépendances du SDK Google Fit via build.gradle : com.google.android.gms:play-services-fitness. Ensuite, vous devez configurer la console Google APIs — créer un projet, activer Fitness API et ajouter des identifiants OAuth 2.0 avec les empreintes SHA-1 correctes.

Le processus d’intégration comprend : initialiser GoogleSignIn avec les portées nécessaires, créer un FitnessClient via Fitness.getClient(), demander l’autorisation de l’utilisateur et effectuer des opérations de lecture ou d’écriture de données. Pour l’enregistrement en arrière-plan, RecordingClient est utilisé, qui collecte automatiquement les données même lorsque l’application est minimisée. Google Fit gère automatiquement la fréquence de collecte des données en fonction du niveau de batterie et de l’activité de l’utilisateur.

Selon Google, les applications avec intégration Google Fit montrent un taux de rétention des utilisateurs 35% plus élevé. Les catégories d’applications clés sont les trackers de fitness, les applications de course, cyclisme, yoga et contrôle du poids.

Il est important de prendre en compte les exigences de confidentialité : Google Fit utilise Restricted Scopes — des portées d’accès spéciales nécessitant une vérification séparée de l’application via OAuth Verification. Le développeur doit décrire quelles données sont collectées, comment elles sont utilisées et combien de temps elles sont conservées. Google exige également une politique de confidentialité et la conformité avec les API Services Terms of Service.

Exemple pratique d’enregistrement

Pour enregistrer des données, un DataSource est créé avec le type, l’appareil et l’application spécifiés. Ensuite, un DataPoint est formé avec un horodatage et des valeurs. Plusieurs DataPoints sont combinés dans un DataSet, qui est transmis à 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("Données enregistrées")
    }