Google Fit — nədir, platforma memarlığı və API

Google Fit nədir?

Google Fit — Google tərəfindən 2014-cü ildə I/O konfransında təqdim edilmiş sağlamlıq idarəetmə platformasıdır. Platforma fiziki aktivlik məlumatlarını oxumaq və yazmaq üçün vahid API təmin edir, tətbiqlərə Google buludunda mərkəzi depozitari vasitəsilə məlumat mübadiləsinə imkan verir.

Proprietar həllərdən fərqli olaraq, Google Fit Android əməliyyat sistemində və iOS-da REST API vasitəsilə işləyir. İstifadəçi fitness bilərzikləri, ağıllı saatlar və aktivlik izləmə tətbiqlərini qoşa bilər, Google Fit isə bütün məlumatları Google Cloud-da vahid sağlamlıq profilində birləşdirir.

Google I/O 2024 məlumatlarına görə, platforma bütün dünyada 5000-dən çox tətbiqdə istifadə olunur və aktiv istifadəçilərin sayı 100 milyonu ötür. Platforma Wear OS ilə inteqrasiya olunub və üçüncü tərəf tətbiqləri vasitəsilə bütün məşhur fitness trekkerlərini dəstəkləyir.

Google Fit memarlığı

Google Fit memarlığı üç səviyyədən qurulub: müştəri SDK, Google Fitness Store bulud deposu və server inteqrasiyası üçün REST API. Müştəri SDK Android (Kotlin, Java) və iOS (Swift, Objective-C) üçün, həmçinin JavaScript vasitəsilə veb-müştəri üçün də mövcuddur.

Məlumatlar mənbələr (DataSource) və məlumat nöqtələri (DataPoint) şəklində təşkil olunur. Hər bir mənbə cihazı və ya tətbiqi təmsil edir, hər bir məlumat nöqtəsi isə vaxt damğası olan bir ölçüdür. Məlumat nöqtələri qrupları sessiyalarda — tipi və müddəti olan fasiləsiz aktivlik dövrlərində birləşdirilir.

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 necə işləyir

Google Fit həm onlayn, həm də oflayn rejimləri dəstəkləyən Google Cloud vasitəsilə sinxronizasiya modelindən istifadə edir. Tətbiq məlumatları lokal olaraq yazır, Google Fit SDK isə internet bağlantısı olduqda onları avtomatik olaraq bulud deposu ilə sinxronlaşdırır. Münaqişələr son yazılış prinsipi ilə həll olunur.

Hər bir məlumat növünün standartlaşdırılmış formatı var: addımlar — TYPE_STEP_COUNT_DELTA, kalorilər — TYPE_CALORIES_EXPENDED, nəbz — TYPE_HEART_RATE_BPM, məsafə — TYPE_DISTANCE_DELTA. Xüsusi növlər üçün Google APIs konsolu vasitəsilə unikal ad sahəsi ilə öz DataType yaradıla bilər.

Platforma iki yazım rejimini dəstəkləyir: aktiv — tətbiq açıqça HistoryClient.insertData() çağırır, və passiv — RecordingClient vasitəsilə, fon məlumat toplanmasına abunə olur. Passiv rejim fitness tətbiqləri üçün rahatdır: istifadəçi tətbiqi bir dəfə işə salır, Google Fit isə prosesor daimi işləmədən tətbiq mövcud olmadıqda avtomatik olaraq addımları, kaloriləri və məsafəni toplayır.

Google məlumatlarına görə, platforma gündə 2 milyarddan çox məlumat nöqtəsi emal edir. Aktiv bağlantıda orta sinxronizasiya gecikməsi 5–10 saniyədir, fon rejimində isə batareyaya qənaət etmək üçün sinxronizasiya hər 30 dəqiqədən bir baş verir.

İstifadəçi razılığı və təhlükəsizlik

Google Fit fitness.activity.read, fitness.activity.write, fitness.body.read və fitness.body.write giriş sahələri ilə avtorizasiya üçün OAuth 2.0-dan istifadə edir. Tətbiq yalnız zəruri sahələri tələb edir, istifadəçi isə hesab seçimi ilə standart Google Sign-In dialoqu vasitəsilə girişi təsdiqləyir.

İstifadəçi istənilən vaxt Google Account Permissions və ya Google Fit tətbiqi vasitəsilə girişi ləğv edə bilər. Google, açıq razılıq olmadan sağlamlıq məlumatlarının üçüncü tərəflərə ötürülməsini və Restricted Scopes siyasətinə uyğun olaraq məlumatların reklam məqsədləri üçün istifadəsini qəti qadağan edir.

Google Fit API

Google Fit üç əsas API təmin edir: tarixi məlumatların oxunması və yazılması üçün Fitness API, sensorlardan real vaxt rejimində məlumat axını üçün Sensors API və aktivlik sessiyalarının idarə edilməsi üçün Sessions API. Hər bir API həm Android SDK, həm də REST sorğuları vasitəsilə əlçatandır.

Fitness API — məlumatlarla işləmək üçün əsas API. O, toplu əməliyyatları dəstəkləyir: bir çağırışda 1000-ə qədər məlumat nöqtəsinin yazılması, vaxt intervalı, məlumat növü və mənbə üzrə filtrasiya ilə oxunması. Məlumatların aqreqasiyası üçün seçilmiş metrikalar üzrə qruplaşdırma ilə DataSet istifadə olunur.

Sensors API real vaxt rejimində sensor məlumatlarına — addımlar, nəbz, təcil — abunə olmağa imkan verir. Məlumatlar sensor növü və tətbiq parametrləri ilə müəyyən edilən tezliklə SensorEventListener vasitəsilə çatdırılır.

Üç əsas API-dən əlavə, Google Fit Recording API-ni təqdim edir — tətbiqi aktiv saxlamaq zörrurəti olmadan avtomatik məlumat toplanması üçün. Bu API xüsusilə Wear OS üçün dəyərlidir: ağıllı saatlar nəbz və aktivlik haqqında məlumatları toplaya bilər, telefondakı tətbiq isə qoşulduqda onlarla sinxronlaşır. Recording API minimum enerji sərfiyyatı üçün optimallaşdırılmış Google Fit Background Services-dən istifadə edir — passiv addım toplanması zamanı gündə 2%-ə qədər batareya sərfiyyatı.

REST API Google Fit fitness.googleapis.com endpointi vasitəsilə əlçatandır. REST API server tətbiqlərinə OAuth avtorizasiyasından sonra istifadəçi adından məlumatları oxumağa və yazmağa imkan verir. Bu, analitik veb-panellər, korporativ fitness proqramları və işçilərin və ya xəstələrin sağlamlıq məlumatlarının mərkəzləşdirilmiş saxlanmasını tələb edən tibbi sistemlər üçün faydalıdır.

val recordingClient = Fitness
    .getRecordingClient(activity, googleSignInAccount)

recordingClient.subscribe(DataType.TYPE_STEP_COUNT_DELTA)
    .addOnSuccessListener {
        println("Abunə aktivdir")
    }

// Tarix məlumatlarının əldə edilməsi
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ü addımlar: $total")
    }

Google Fit-in tətbiqə inteqrasiyası

Google Fit inteqrasiyası build.gradle vasitəsilə Google Fit SDK asılılıqlarının qoşulması ilə başlayır: com.google.android.gms:play-services-fitness. Bundan sonra Google APIs konsolunu konfiqurasiya etmək — layihə yaratmaq, Fitness API-ni aktivləşdirmək və düzgün SHA-1 barmaq izləri ilə OAuth 2.0 etimadnamələri əlavə etmək lazımdır.

İnteqrasiya prosesinə daxildir: tələb olunan sahələrlə GoogleSignIn-in işə salınması, Fitness.getClient() vasitəsilə FitnessClient-in yaradılması, istifadəçidən avtorizasiyanın tələb edilməsi və məlumatların oxunması və ya yazılması əməliyyatlarının yerinə yetirilməsi. Fon yazısı üçün tətbiq mövcud olmadıqda belə avtomatik məlumat toplayan RecordingClient istifadə olunur. Google Fit batareya səviyyəsi və istifadəçi aktivliyindən asılı olaraq məlumat toplanması tezliyini avtomatik idarə edir.

Google məlumatlarına görə, Google Fit inteqrasiyası olan tətbiqlər istifadəçi saxlama səviyyəsində 35% daha yüksək göstərici nümayiş etdirir. Əsas tətbiq kateqoriyaları — fitness trekkerlər, qaçış, velosiped, yoqa və çəki nəzarəti tətbiqləri.

Məxfilik tələblərini nəzərə almaq vacibdir: Google Fit Restricted Scopes-dan — OAuth Verification vasitəsilə tətbiqin ayrıca yoxlanmasını tələb edən xüsusi giriş sahələrindən istifadə edir. Tərtibatçı hansı məlumatların toplandığını, onların necə istifadə edildiyini və nə qədər saxlanıldığını təsvir etməlidir. Google həmçinin məxfilik siyasətinin və API Services Terms of Service proqramına uyğunluğun olmasını tələb edir.

Yazının praktiki nümunəsi

Məlumatları yazmaq üçün tipi, cihazı və tətbiqi göstərən DataSource yaradılır. Sonra vaxt damğası və dəyərlərlə DataPoint formalaşdırılır. Çoxlu DataPoint-lər DataSet-də birləşdirilir və HistoryClient.write()-a ötürülür.

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("Məlumatlar yadda saxlanıldı")
    }