Google Fit — nima, platforma arxitekturasi va API

Google Fit nima?

Google Fit — Google tomonidan 2014-yilda I/O konferentsiyasida taqdim etilgan sog’liqni boshqarish platformasidir. Platforma jismoniy faollik ma’lumotlarini o’qish va yozish uchun yagona API taqdim etadi, ilovalarga Google bulutidagi markaziy ombor orqali ma’lumot almashish imkonini beradi.

Xususiy yechimlardan farqli o’laroq, Google Fit Android operatsion tizimida va iOS-da REST API orqali ishlaydi. Foydalanuvchi fitnes bilakuzuklar, aqlli soatlar va faollik kuzatuv ilovalarini ulashi mumkin, Google Fit esa barcha ma’lumotlarni Google Cloud-da yagona sog’liq profilida birlashtiradi.

Google I/O 2024 ma’lumotlariga ko’ra, platforma butun dunyo bo’ylab 5000 dan ortiq ilovalarda qo’llaniladi va faol foydalanuvchilar soni 100 milliondan oshadi. Platforma Wear OS bilan integratsiyalangan va uchinchi tomon ilovalari orqali barcha mashhur fitnes kuzatuvchilarini qo’llab-quvvatlaydi.

Google Fit arxitekturasi

Google Fit arxitekturasi uch darajadan qurilgan: mijoz SDK, Google Fitness Store bulut ombori va server integratsiyasi uchun REST API. Mijoz SDK Android (Kotlin, Java) va iOS (Swift, Objective-C) uchun, shuningdek JavaScript orqali veb-mijoz uchun mavjud.

Ma’lumotlar manbalar (DataSource) va ma’lumot nuqtalari (DataPoint) shaklida tashkil etiladi. Har bir manba qurilma yoki ilovani ifodalaydi, har bir ma’lumot nuqtasi esa vaqt tamg’asi bilan bitta o’lchovdir. Ma’lumot nuqtalari guruhlari sessiyalarda — turi va davomiyligi bo’lgan uzluksiz faollik davrlarida birlashtiriladi.

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 qanday ishlaydi

Google Fit onlayn va oflayn rejimlarni qo’llab-quvvatlovchi Google Cloud orqali sinxronizatsiya modelidan foydalanadi. Ilova ma’lumotlarni mahalliy ravishda yozadi, Google Fit SDK esa internet aloqasi mavjud bo’lganda ularni avtomatik ravishda bulut ombori bilan sinxronlashtiradi. Mojarolar oxirgi yozilish printsipi bo’yicha hal qilinadi.

Har bir ma’lumot turi standartlashtirilgan formatga ega: qadamlar — TYPE_STEP_COUNT_DELTA, kaloriyalar — TYPE_CALORIES_EXPENDED, yurak urishi — TYPE_HEART_RATE_BPM, masofa — TYPE_DISTANCE_DELTA. Maxsus turlar uchun Google APIs konsoli orqali noyob nom maydoni bilan o’z DataType yaratilishi mumkin.

Platforma ikkita yozish rejimini qo’llab-quvvatlaydi: faol — ilova aniq HistoryClient.insertData() ni chaqiradi, va passiv — fon ma’lumot yig’ishga obuna bo’ladigan RecordingClient orqali. Passiv rejim fitnes ilovalari uchun qulay: foydalanuvchi ilovani bir marta ishga tushiradi, Google Fit esa protsessor doimiy ishlamasdan ilova minimallashtirilganda avtomatik ravishda qadamlar, kaloriyalar va masofani to’playdi.

Google ma’lumotlariga ko’ra, platforma kuniga 2 milliarddan ortiq ma’lumot nuqtasini qayta ishlaydi. Faol ulanishda o’rtacha sinxronizatsiya kechikishi 5–10 soniya, fon rejimida esa batareyani tejash uchun sinxronizatsiya har 30 daqiqada amalga oshiriladi.

Foydalanuvchi roziligi va xavfsizlik

Google Fit fitness.activity.read, fitness.activity.write, fitness.body.read va fitness.body.write kirish doiralari bilan avtorizatsiya uchun OAuth 2.0 dan foydalanadi. Ilova faqat zaruriy doiralarni talab qiladi, foydalanuvchi esa hisob tanlash bilan standart Google Sign-In dialogi orqali kirishni tasdiqlaydi.

Foydalanuvchi istalgan vaqtda Google Account Permissions yoki Google Fit ilovasi orqali kirishni bekor qilishi mumkin. Google aniq roziliksiz sog’liq ma’lumotlarini uchinchi shaxslarga uzatishni va Restricted Scopes siyosatiga muvofiq ma’lumotlardan reklama maqsadlarida foydalanishni qat’iyan taqiqlaydi.

Google Fit API

Google Fit uchta asosiy API-ni taqdim etadi: tarixiy ma’lumotlarni o’qish va yozish uchun Fitness API, sensorlardan real vaqt ma’lumotlar oqimi uchun Sensors API va faollik sessiyalarini boshqarish uchun Sessions API. Har bir API Android SDK orqali ham, REST so’rovlari orqali ham mavjud.

Fitness API — ma’lumotlar bilan ishlash uchun asosiy API. U guruhli operatsiyalarni qo’llab-quvvatlaydi: bitta chaqiruvda 1000 tagacha ma’lumot nuqtasini yozish, vaqt oralig’i, ma’lumot turi va manba bo’yicha filtrlash bilan o’qish. Ma’lumotlarni jamlash uchun tanlangan ko’rsatkichlar bo’yicha guruhlash bilan DataSet ishlatiladi.

Sensors API real vaqt sensor ma’lumotlariga — qadamlar, yurak urishi, tezlanish — obuna bo’lish imkonini beradi. Ma’lumotlar sensor turi va ilova sozlamalari bilan belgilanadigan chastotada SensorEventListener orqali yetkaziladi.

Uchta asosiy API dan tashqari, Google Fit Recording API ni taqdim etadi — ilovani faol ushlab turish zaruratisiz avtomatik ma’lumot yig’ish uchun. Bu API ayniqsa Wear OS uchun qimmatlidir: aqlli soatlar yurak urishi va faollik haqida ma’lumot to’plashi mumkin, telefondagi ilova esa ulanishda ular bilan sinxronlashadi. Recording API minimal energiya sarfi uchun optimallashtirilgan Google Fit Background Services dan foydalanadi — passiv qadam yig’ishda kuniga 2% gacha batareya sarfi.

REST API Google Fit fitness.googleapis.com endpointi orqali mavjud. REST API server ilovalariga OAuth avtorizatsiyasidan so’ng foydalanuvchi nomidan ma’lumotlarni o’qish va yozish imkonini beradi. Bu veb-analitik panellar, korporativ fitnes dasturlari va xodimlar yoki bemorlarning sog’liq ma’lumotlarini markazlashtirilgan saqlash talab qilinadigan tibbiy tizimlar uchun foydalidir.

val recordingClient = Fitness
    .getRecordingClient(activity, googleSignInAccount)

recordingClient.subscribe(DataType.TYPE_STEP_COUNT_DELTA)
    .addOnSuccessListener {
        println("Obuna faol")
    }

// Tarix ma’lumotlarini olish
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("Bugungi qadamlar: $total")
    }

Google Fit-ni ilovaga integratsiya qilish

Google Fit integratsiyasi build.gradle orqali Google Fit SDK bog’liqliklarini qo’shish bilan boshlanadi: com.google.android.gms:play-services-fitness. Keyin Google APIs konsolini sozlash — loyiha yaratish, Fitness API-ni faollashtirish va to’g’ri SHA-1 barmoq izlari bilan OAuth 2.0 ma’lumotlarini qo’shish kerak.

Integratsiya jarayoni o‘z ichiga oladi: kerakli doiralar bilan GoogleSignIn-ni ishga tushirish, Fitness.getClient() orqali FitnessClient yaratish, foydalanuvchidan avtorizatsiya so’rash va ma’lumotlarni o’qish yoki yozish operatsiyalarini bajarish. Fon yozish uchun ilova minimallashtirilganda ham avtomatik ma’lumot to’playdigan RecordingClient ishlatiladi. Google Fit batareya darajasi va foydalanuvchi faolligiga qarab ma’lumot yig’ish chastotasini avtomatik boshqaradi.

Google ma’lumotlariga ko’ra, Google Fit integratsiyasiga ega ilovalar foydalanuvchilarni ushlab qolish darajasida 35% yuqori ko’rsatkichni namoyish etadi. Asosiy ilova toifalari — fitnes kuzatuvchilar, yugurish, velosiped, yoga va vazn nazorati ilovalari.

Maxfiylik talablarini hisobga olish muhim: Google Fit Restricted Scopes — OAuth Verification orqali alohida tekshirishni talab qiluvchi maxsus kirish doiralaridan foydalanadi. Dasturchi qanday ma’lumotlar to’planishi, ulardan qanday foydalanish va qancha vaqt saqlanishini tavsiflashi kerak. Google shuningdek maxfiylik siyosati mavjudligini va API Services Terms of Service dasturiga muvofiqlikni talab qiladi.

Yozishning amaliy misoli

Ma’lumotlarni yozish uchun turi, qurilmasi va ilovasi ko’rsatilgan DataSource yaratiladi. Keyin vaqt tamg’asi va qiymatlar bilan DataPoint shakllantiriladi. Bir nechta DataPoint-lar DataSet-da birlashtiriladi va HistoryClient.write() ga uzatiladi.

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("Ma’lumotlar saqlandi")
    }