Google Fit — apa itu, arsitektur platform dan API

Apa itu Google Fit?

Google Fit adalah platform manajemen kesehatan yang diluncurkan oleh Google pada tahun 2014 di konferensi I/O. Platform ini menyediakan API terpadu untuk membaca dan menulis data aktivitas fisik, memungkinkan aplikasi untuk bertukar informasi melalui penyimpanan terpusat di cloud Google.

Tidak seperti solusi proprietary, Google Fit bekerja pada sistem operasi Android dan iOS melalui REST API. Pengguna dapat menghubungkan gelang kebugaran, jam tangan pintar, dan aplikasi pelacak aktivitas, dan Google Fit menggabungkan semua data ke dalam satu profil kesehatan di Google Cloud.

Menurut Google I/O 2024, platform ini digunakan di lebih dari 5000 aplikasi di seluruh dunia, dan jumlah pengguna aktif melebihi 100 juta. Platform ini terintegrasi dengan Wear OS dan mendukung semua pelacak kebugaran populer melalui aplikasi pihak ketiga.

Arsitektur Google Fit

Arsitektur Google Fit dibangun di atas tiga tingkat: SDK klien, penyimpanan cloud Google Fitness Store dan REST API untuk integrasi server. SDK klien tersedia untuk Android (Kotlin, Java) dan iOS (Swift, Objective-C), serta klien web melalui JavaScript.

Data diorganisasikan dalam bentuk sumber (DataSource) dan titik data (DataPoint). Setiap sumber mewakili perangkat atau aplikasi, dan setiap titik data mewakili satu pengukuran dengan cap waktu. Kelompok titik data digabungkan ke dalam sesi — periode aktivitas berkelanjutan dengan tipe dan durasi.

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

Cara kerja Google Fit

Google Fit menggunakan model sinkronisasi melalui Google Cloud dengan dukungan mode online dan offline. Aplikasi menulis data secara lokal, dan Google Fit SDK secara otomatis menyinkronkannya dengan penyimpanan cloud saat ada koneksi internet. Konflik diselesaikan berdasarkan prinsip penulisan terakhir.

Setiap tipe data memiliki format standar: langkah — TYPE_STEP_COUNT_DELTA, kalori — TYPE_CALORIES_EXPENDED, detak jantung — TYPE_HEART_RATE_BPM, jarak — TYPE_DISTANCE_DELTA. Untuk tipe kustom, dapat dibuat DataType sendiri melalui konsol Google APIs dengan namespace unik.

Platform mendukung dua mode penulisan: aktif — aplikasi secara eksplisit memanggil HistoryClient.insertData(), dan pasif — melalui RecordingClient, yang berlangganan pengumpulan data di latar belakang. Mode pasif nyaman untuk aplikasi kebugaran: pengguna menjalankan aplikasi sekali, dan Google Fit secara otomatis mengumpulkan langkah, kalori, dan jarak saat aplikasi diminimalkan tanpa kerja prosesor terus-menerus.

Menurut Google, platform memproses lebih dari 2 miliar titik data setiap hari. Rata-rata penundaan sinkronisasi adalah 5–10 detik pada koneksi aktif, dan dalam mode latar belakang sinkronisasi terjadi setiap 30 menit untuk menghemat baterai.

Persetujuan pengguna dan keamanan

Google Fit menggunakan OAuth 2.0 untuk otorisasi dengan cakupan akses fitness.activity.read, fitness.activity.write, fitness.body.read dan fitness.body.write. Aplikasi hanya meminta cakupan yang diperlukan, dan pengguna mengonfirmasi akses melalui dialog Google Sign-In standar dengan pemilihan akun.

Pengguna dapat kapan saja mencabut akses melalui Google Account Permissions atau aplikasi Google Fit. Google dengan tegas melarang transfer data kesehatan ke pihak ketiga tanpa persetujuan eksplisit, serta penggunaan data untuk tujuan periklanan sesuai dengan kebijakan Restricted Scopes.

API Google Fit

Google Fit menyediakan tiga API utama: Fitness API untuk membaca dan menulis data historis, Sensors API untuk streaming data real-time dari sensor, dan Sessions API untuk mengelola sesi aktivitas. Setiap API tersedia baik melalui Android SDK maupun melalui permintaan REST.

Fitness API — API utama untuk bekerja dengan data. Mendukung operasi batch: menulis hingga 1000 titik data dalam satu panggilan, membaca dengan filter berdasarkan rentang waktu, tipe data, dan sumber. Untuk agregasi data digunakan DataSet dengan pengelompokan berdasarkan metrik yang dipilih.

Sensors API memungkinkan berlangganan data sensor real-time — langkah, detak jantung, akselerasi. Data dikirimkan melalui SensorEventListener dengan frekuensi yang ditentukan oleh tipe sensor dan pengaturan aplikasi.

Selain tiga API utama, Google Fit menyediakan Recording API untuk pengumpulan data otomatis tanpa perlu menjaga aplikasi tetap aktif. API ini sangat berharga untuk Wear OS: jam tangan pintar dapat mengumpulkan data detak jantung dan aktivitas, dan aplikasi di ponsel sinkron dengannya saat terhubung. Recording API menggunakan Google Fit Background Services yang dioptimalkan untuk konsumsi daya minimal — hingga 2% baterai per hari saat pengumpulan langkah pasif.

REST API Google Fit dapat diakses melalui endpoint fitness.googleapis.com. REST API memungkinkan aplikasi server untuk membaca dan menulis data atas nama pengguna setelah otorisasi OAuth. Ini berguna untuk dashboard analitik web, program kebugaran perusahaan, dan sistem medis yang memerlukan penyimpanan terpusat data kesehatan karyawan atau pasien.

val recordingClient = Fitness
    .getRecordingClient(activity, googleSignInAccount)

recordingClient.subscribe(DataType.TYPE_STEP_COUNT_DELTA)
    .addOnSuccessListener {
        println("Langganan aktif")
    }

// Mendapatkan data riwayat
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("Langkah hari ini: $total")
    }

Integrasi Google Fit ke dalam aplikasi

Integrasi Google Fit dimulai dengan menambahkan dependensi Google Fit SDK melalui build.gradle: com.google.android.gms:play-services-fitness. Setelah itu perlu mengonfigurasi konsol Google APIs — membuat proyek, mengaktifkan Fitness API dan menambahkan kredensial OAuth 2.0 dengan sidik jari SHA-1 yang benar.

Proses integrasi meliputi: inisialisasi GoogleSignIn dengan cakupan yang diperlukan, pembuatan FitnessClient melalui Fitness.getClient(), meminta otorisasi dari pengguna dan melakukan operasi baca atau tulis data. Untuk penulisan latar belakang digunakan RecordingClient, yang secara otomatis mengumpulkan data bahkan saat aplikasi diminimalkan. Google Fit secara otomatis mengelola frekuensi pengumpulan data tergantung pada tingkat baterai dan aktivitas pengguna.

Menurut Google, aplikasi dengan integrasi Google Fit menunjukkan tingkat retensi pengguna 35% lebih tinggi. Kategori aplikasi utama — pelacak kebugaran, aplikasi lari, bersepeda, yoga, dan kontrol berat badan.

Penting untuk mempertimbangkan persyaratan privasi: Google Fit menggunakan Restricted Scopes — cakupan akses khusus yang memerlukan verifikasi terpisah aplikasi melalui OAuth Verification. Pengembang harus menjelaskan data apa yang dikumpulkan, bagaimana digunakan, dan berapa lama disimpan. Google juga memerlukan kebijakan privasi dan kepatuhan terhadap program API Services Terms of Service.

Contoh praktis penulisan

Untuk menulis data, dibuat DataSource dengan menentukan tipe, perangkat, dan aplikasi. Kemudian dibentuk DataPoint dengan cap waktu dan nilai. Banyak DataPoint digabungkan dalam DataSet, yang diteruskan ke 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("Data disimpan")
    }