Google Fit — nedir, platform mimarisi ve API’ler

Google Fit nedir?

Google Fit, Google tarafından 2014 yılında I/O konferansında başlatılan bir sağlık yönetimi platformudur. Platform, fiziksel aktivite verilerini okumak ve yazmak için birleşik bir API sağlayarak uygulamaların Google bulutundaki merkezi bir depo aracılığıyla bilgi alışverişi yapmasına olanak tanır.

Tescilli çözümlerin aksine Google Fit, Android işletim sistemi ve REST API aracılığıyla iOS üzerinde çalışır. Kullanıcılar fitness bileklikleri, akıllı saatler ve aktivite takip uygulamalarını bağlayabilir ve Google Fit, tüm verileri Google Cloud’da tek bir sağlık profilinde toplar.

Google I/O 2024’e göre platform, dünya çapında 5000’den fazla uygulamada kullanılmakta ve aktif kullanıcı sayısı 100 milyonu aşmaktadır. Platform, Wear OS ile entegredir ve üçüncü taraf uygulamalar aracılığıyla tüm popüler fitness takipçilerini destekler.

Google Fit mimarisi

Google Fit mimarisi üç katman üzerine kurulmuştur: istemci SDK, Google Fitness Store bulut depolama ve sunucu entegrasyonu için REST API. İstemci SDK, Android (Kotlin, Java) ve iOS (Swift, Objective-C) için kullanılabilir ve JavaScript aracılığıyla bir web istemcisi de mevcuttur.

Veriler kaynaklar (DataSource) ve veri noktaları (DataPoint) olarak düzenlenir. Her kaynak bir cihazı veya uygulamayı temsil eder ve her veri noktası, bir zaman damgasıyla birlikte tek bir ölçümü temsil eder. Veri noktası grupları, oturumlar halinde birleştirilir — bir tür ve süreye sahip sürekli aktivite dönemleri.

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 nasıl çalışır

Google Fit, çevrimiçi ve çevrimdışı modları destekleyen Google Cloud aracılığıyla bir senkronizasyon modeli kullanır. Uygulama verileri yerel olarak kaydeder ve Google Fit SDK, internet bağlantısı olduğunda bunları otomatik olarak bulut depolamayla senkronize eder. Çakışmalar, son yazma ilkesine göre çözülür.

Her veri türünün standartlaştırılmış bir biçimi vardır: adımlar — TYPE_STEP_COUNT_DELTA, kaloriler — TYPE_CALORIES_EXPENDED, kalp atış hızı — TYPE_HEART_RATE_BPM, mesafe — TYPE_DISTANCE_DELTA. Özel türler için, Google APIs Konsolu aracılığıyla benzersiz bir ad alanına sahip özel DataType oluşturabilirsiniz.

Platform iki kayıt modunu destekler: aktif — uygulama açıkça HistoryClient.insertData()’ı çağırır ve pasif — arka planda veri toplamaya abone olan RecordingClient aracılığıyla. Pasif mod, fitness uygulamaları için kullanışlıdır: kullanıcı uygulamayı bir kez başlatır ve Google Fit, uygulama küçültüldüğünde bile sürekli CPU kullanımı olmadan adımları, kalorileri ve mesafeyi otomatik olarak toplar.

Google’a göre platform, günlük 2 milyardan fazla veri noktasını işler. Aktif bağlantıda ortalama senkronizasyon gecikmesi 5–10 saniyedir ve arka plan modunda pil tasarrufu için senkronizasyon her 30 dakikada bir gerçekleşir.

Kullanıcı onayı ve güvenlik

Google Fit, yetkilendirme için OAuth 2.0 kullanır ve fitness.activity.read, fitness.activity.write, fitness.body.read ve fitness.body.write erişim kapsamlarını içerir. Uygulama yalnızca gerekli kapsamları talep eder ve kullanıcı, hesap seçimiyle standart Google Sign-In iletişim kutusu aracılığıyla erişimi onaylar.

Kullanıcı, Google Account Permissions veya Google Fit uygulaması aracılığıyla erişimi istediği zaman iptal edebilir. Google, açık rıza olmadan sağlık verilerinin üçüncü taraflarla paylaşılmasını ve Restricted Scopes politikasına göre verilerin reklam amaçlı kullanılmasını kesinlikle yasaklar.

Google Fit API’leri

Google Fit üç ana API sağlar: geçmiş verileri okumak ve yazmak için Fitness API, sensörlerden gerçek zamanlı veri akışı için Sensors API ve aktivite oturumlarını yönetmek için Sessions API. Her API, hem Android SDK hem de REST istekleri aracılığıyla kullanılabilir.

Fitness API, verilerle çalışmak için ana API’dir. Toplu işlemleri destekler: tek bir çağrıda 1000’e kadar veri noktası yazma, zaman aralığına, veri türüne ve kaynağa göre filtreleyerek okuma. Veri toplama için, seçilen metriklerle gruplandırılmış DataSet kullanılır.

Sensors API, gerçek zamanlı sensör verilerine — adımlar, kalp atış hızı, ivme — abone olmayı sağlar. Veriler, sensör türü ve uygulama ayarlarına göre belirlenen bir frekansta SensorEventListener aracılığıyla alınır.

Üç ana API’ye ek olarak Google Fit, uygulamayı aktif tutmaya gerek kalmadan otomatik veri toplama için Recording API sağlar. Bu API özellikle Wear OS için değerlidir: akıllı saatler kalp atış hızı ve aktivite verilerini toplayabilir ve bağlantı kurulduğunda telefon uygulaması bunlarla senkronize olur. Recording API, minimum güç tüketimi için optimize edilmiş Google Fit Background Services’ı kullanır — pasif adım toplamada günde %2’ye kadar pil tüketimi.

REST API Google Fit, fitness.googleapis.com uç noktasında kullanılabilir. REST API, sunucu uygulamalarının OAuth yetkilendirmesinden sonra kullanıcı adına veri okumasına ve yazmasına olanak tanır. Bu, web analiz panoları, kurumsal fitness programları ve çalışan veya hasta sağlık verilerinin merkezi depolanmasını gerektiren tıbbi sistemler için kullanışlıdır.

val recordingClient = Fitness
    .getRecordingClient(activity, googleSignInAccount)

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

// Geçmiş verileri alma
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("Bugünkü adımlar: $total")
    }

Google Fit’i uygulamaya entegre etme

Google Fit entegrasyonu, build.gradle aracılığıyla Google Fit SDK bağımlılıklarının eklenmesiyle başlar: com.google.android.gms:play-services-fitness. Ardından, Google APIs Konsolu’nu yapılandırmanız gerekir — bir proje oluşturun, Fitness API’yi etkinleştirin ve doğru SHA-1 parmak izlerine sahip OAuth 2.0 kimlik bilgileri ekleyin.

Entegrasyon süreci şunları içerir: gerekli kapsamlarla GoogleSignIn’i başlatma, Fitness.getClient() aracılığıyla bir FitnessClient oluşturma, kullanıcıdan yetkilendirme isteme ve veri okuma veya yazma işlemlerini gerçekleştirme. Arka plan kaydı için, uygulama küçültüldüğünde bile otomatik olarak veri toplayan RecordingClient kullanılır. Google Fit, pil seviyesine ve kullanıcı aktivitesine göre veri toplama sıklığını otomatik olarak yönetir.

Google’a göre, Google Fit entegrasyonuna sahip uygulamalar %35 daha yüksek kullanıcı tutma oranı gösterir. Ana uygulama kategorileri fitness takipçileri, koşu, bisiklet, yoga ve kilo kontrolü uygulamalarıdır.

Gizlilik gereksinimlerini dikkate almak önemlidir: Google Fit, OAuth Verification aracılığıyla ayrı uygulama doğrulaması gerektiren özel erişim kapsamları olan Restricted Scopes kullanır. Geliştirici, hangi verilerin toplandığını, nasıl kullanıldığını ve ne kadar süre saklandığını açıklamalıdır. Google ayrıca bir gizlilik politikası ve API Services Terms of Service’e uygunluk gerektirir.

Pratik kayıt örneği

Veri kaydetmek için tür, cihaz ve uygulama belirtilerek bir DataSource oluşturulur. Ardından bir zaman damgası ve değerlerle bir DataPoint oluşturulur. Birden çok DataPoint, HistoryClient.write()’a iletilen bir DataSet’te birleştirilir.

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("Veriler kaydedildi")
    }