Google Fit — یہ کیا ہے، پلیٹ فارم کا فن تعمیر اور API

Google Fit کیا ہے؟

Google Fit ایک صحت کے انتظام کا پلیٹ فارم ہے جسے Google نے 2014 میں I/O کانفرنس میں لانچ کیا تھا۔ یہ پلیٹ فارم جسمانی سرگرمی کے ڈیٹا کو پڑھنے اور لکھنے کے لیے ایک متحدہ API فراہم کرتا ہے، جس سے ایپلیکیشنز Google کلاؤڈ میں مرکزی ذخیرے کے ذریعے معلومات کا تبادلہ کر سکتی ہیں۔

ملکیتی حل کے برعکس، Google Fit Android آپریٹنگ سسٹم اور REST API کے ذریعے iOS پر کام کرتا ہے۔ صارفین فٹنس بینڈز، سمارٹ واچز اور سرگرمی سے باخبر رہنے والی ایپلیکیشنز کو جوڑ سکتے ہیں، اور Google Fit تمام ڈیٹا کو Google Cloud میں ایک ہی صحت پروفائل میں جمع کرتا ہے۔

Google I/O 2024 کے مطابق، یہ پلیٹ فارم دنیا بھر میں 5000 سے زیادہ ایپلیکیشنز میں استعمال ہوتا ہے اور فعال صارفین کی تعداد 100 ملین سے تجاوز کر گئی ہے۔ یہ پلیٹ فارم Wear OS کے ساتھ مربوط ہے اور تیسرے فریق کی ایپلیکیشنز کے ذریعے تمام مقبول فٹنس ٹریکرز کو سپورٹ کرتا ہے۔

Google Fit کا فن تعمیر

Google Fit کا فن تعمیر تین تہوں پر بنایا گیا ہے: کلائنٹ SDK، Google Fitness Store کلاؤڈ اسٹوریج اور سرور انضمام کے لیے REST API۔ کلائنٹ SDK Android (Kotlin, Java) اور iOS (Swift, Objective-C) کے لیے دستیاب ہے، اور JavaScript کے ذریعے ایک ویب کلائنٹ بھی ہے۔

ڈیٹا ذریعہ (DataSource) اور ڈیٹا پوائنٹ (DataPoint) کی شکل میں منظم کیا جاتا ہے۔ ہر ذریعہ ایک ڈیوائس یا ایپلیکیشن کی نمائندگی کرتا ہے، اور ہر ڈیٹا پوائنٹ ایک ٹائم سٹیمپ کے ساتھ ایک پیمائش کی نمائندگی کرتا ہے۔ ڈیٹا پوائنٹس کے گروپس سیشنز میں یکجا ہوتے ہیں — ایک قسم اور دورانیے کے ساتھ سرگرمی کی مسلسل مدت۔

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 کیسے کام کرتا ہے

Google Fit آن لائن اور آف لائن دونوں طریقوں کی حمایت کے ساتھ Google Cloud کے ذریعے ایک ہم آہنگی کے ماڈل کا استعمال کرتا ہے۔ ایپلیکیشن ڈیٹا کو مقامی طور پر ریکارڈ کرتی ہے، اور Google Fit SDK انٹرنیٹ کنکشن دستیاب ہونے پر خود بخود کلاؤڈ اسٹوریج کے ساتھ ہم آہنگ کرتا ہے۔ تنازعات آخری تحریر کے اصول پر حل کیے جاتے ہیں۔

ہر ڈیٹا کی قسم کا ایک معیاری شکل ہوتا ہے: قدم — TYPE_STEP_COUNT_DELTA، کیلوریز — TYPE_CALORIES_EXPENDED، دل کی دھڑکن — TYPE_HEART_RATE_BPM، فاصلہ — TYPE_DISTANCE_DELTA۔ کسٹم اقسام کے لیے، آپ Google APIs Console کے ذریعے ایک منفرد نام کی جگہ کے ساتھ کسٹم DataType بنا سکتے ہیں۔

پلیٹ فارم دو ریکارڈنگ موڈز کو سپورٹ کرتا ہے: فعال — ایپلیکیشن واضح طور پر HistoryClient.insertData() کو کال کرتی ہے، اور غیر فعال — RecordingClient کے ذریعے، جو پس منظر میں ڈیٹا اکٹھا کرنے کے لیے سبسکرائب کرتا ہے۔ غیر فعال موڈ فٹنس ایپلیکیشنز کے لیے آسان ہے: صارف ایک بار ایپلیکیشن لانچ کرتا ہے، اور Google Fit خود بخود ایپلیکیشن کے کم سے کم ہونے پر بغیر مسلسل CPU استعمال کے قدم، کیلوریز اور فاصلہ اکٹھا کرتا ہے۔

Google کے مطابق، پلیٹ فارم روزانہ 2 ارب سے زیادہ ڈیٹا پوائنٹس پر کارروائی کرتا ہے۔ فعال کنکشن کے ساتھ اوسط ہم آہنگی تاخیر 5–10 سیکنڈ ہے، اور پس منظر کے موڈ میں بیٹری بچانے کے لیے ہم آہنگی ہر 30 منٹ میں ہوتی ہے۔

صارف کی رضامندی اور حفاظت

Google Fit اجازت کے لیے OAuth 2.0 استعمال کرتا ہے جس میں رسائی کے دائرہ کار fitness.activity.read، fitness.activity.write، fitness.body.read اور fitness.body.write شامل ہیں۔ ایپلیکیشن صرف ضروری دائرہ کار کی درخواست کرتی ہے، اور صارف اکاؤنٹ کے انتخاب کے ساتھ معیاری Google Sign-In ڈائیلاگ کے ذریعے رسائی کی تصدیق کرتا ہے۔

صارف Google Account Permissions یا Google Fit ایپلیکیشن کے ذریعے کسی بھی وقت رسائی منسوخ کر سکتا ہے۔ Google واضح رضامندی کے بغیر تیسرے فریق کے ساتھ صحت کے ڈیٹا کا اشتراک کرنے اور Restricted Scopes پالیسی کے مطابق اشتہاری مقاصد کے لیے ڈیٹا کے استعمال سے سختی سے منع کرتا ہے۔

Google Fit API

Google Fit تین اہم API فراہم کرتا ہے: تاریخی ڈیٹا کو پڑھنے اور لکھنے کے لیے Fitness API، سینسرز سے ریئل ٹائم ڈیٹا اسٹریمنگ کے لیے Sensors API اور سرگرمی سیشنز کے انتظام کے لیے Sessions API۔ ہر API Android SDK اور REST درخواستوں دونوں کے ذریعے دستیاب ہے۔

Fitness API ڈیٹا کے ساتھ کام کرنے کے لیے بنیادی API ہے۔ یہ بیچ آپریشنز کو سپورٹ کرتا ہے: ایک کال میں 1000 ڈیٹا پوائنٹس تک لکھنا، وقت کی حد، ڈیٹا کی قسم اور ماخذ کے مطابق فلٹر کرکے پڑھنا۔ ڈیٹا اکٹھا کرنے کے لیے، منتخب میٹرکس کے ساتھ گروپ کرنے والا DataSet استعمال ہوتا ہے۔

Sensors API ریئل ٹائم سینسر ڈیٹا — قدم، دل کی دھڑکن، ایکسلریشن — کو سبسکرائب کرنے کی اجازت دیتا ہے۔ ڈیٹا سینسر کی قسم اور ایپلیکیشن کی ترتیبات کے ذریعے متعین تعدد پر SensorEventListener کے ذریعے موصول ہوتا ہے۔

تین اہم API کے علاوہ، Google Fit ایپلیکیشن کو فعال رکھنے کی ضرورت کے بغیر خودکار ڈیٹا اکٹھا کرنے کے لیے Recording API فراہم کرتا ہے۔ یہ API خاص طور پر Wear OS کے لیے قیمتی ہے: سمارٹ واچز دل کی دھڑکن اور سرگرمی کا ڈیٹا اکٹھا کر سکتی ہیں، اور کنیکٹ ہونے پر فون ایپلیکیشن ان کے ساتھ ہم آہنگ ہوتی ہے۔ Recording API Google Fit Background Services کا استعمال کرتا ہے، جو کم سے کم بجلی کی کھپت کے لیے بہتر بنایا گیا ہے — غیر فعال قدموں کے جمع کرنے کے ساتھ روزانہ 2% تک بیٹری۔

REST API Google Fit fitness.googleapis.com اینڈپوائنٹ پر دستیاب ہے۔ REST API سرور ایپلیکیشنز کو OAuth اجازت کے بعد صارف کی جانب سے ڈیٹا پڑھنے اور لکھنے کی اجازت دیتا ہے۔ یہ ویب تجزیاتی ڈیش بورڈز، کارپوریٹ فٹنس پروگرامز اور طبی نظاموں کے لیے مفید ہے جنہیں ملازمین یا مریضوں کے صحت کے ڈیٹا کے مرکزی ذخیرہ کی ضرورت ہوتی ہے۔

val recordingClient = Fitness
    .getRecordingClient(activity, googleSignInAccount)

recordingClient.subscribe(DataType.TYPE_STEP_COUNT_DELTA)
    .addOnSuccessListener {
        println("سبسکرپشن فعال ہے")
    }

// تاریخ کا ڈیٹا حاصل کرنا
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("آج کے قدم: $total")
    }

ایپلیکیشن میں Google Fit کا انضمام

Google Fit کا انضمام build.gradle کے ذریعے Google Fit SDK انحصار شامل کرنے سے شروع ہوتا ہے: com.google.android.gms:play-services-fitness۔ اس کے بعد، آپ کو Google APIs Console ترتیب دینے کی ضرورت ہے — ایک پروجیکٹ بنائیں، Fitness API کو فعال کریں اور درست SHA-1 فنگر پرنٹس کے ساتھ OAuth 2.0 اسناد شامل کریں۔

انضمام کے عمل میں شامل ہیں: ضروری دائرہ کار کے ساتھ GoogleSignIn شروع کرنا، Fitness.getClient() کے ذریعے FitnessClient بنانا، صارف سے اجازت کی درخواست کرنا اور ڈیٹا پڑھنے یا لکھنے کے آپریشنز انجام دینا۔ پس منظر میں ریکارڈنگ کے لیے RecordingClient استعمال ہوتا ہے، جو ایپلیکیشن کے کم سے کم ہونے پر بھی خود بخود ڈیٹا اکٹھا کرتا ہے۔ Google Fit بیٹری کی سطح اور صارف کی سرگرمی کی بنیاد پر خود بخود ڈیٹا اکٹھا کرنے کی تعدد کا انتظام کرتا ہے۔

Google کے مطابق، Google Fit انضمام والی ایپلیکیشنز 35% زیادہ صارف برقرار رکھنے کی شرح دکھاتی ہیں۔ اہم ایپلیکیشن زمرے — فٹنس ٹریکرز، دوڑ، سائیکلنگ، یوگا اور وزن کنٹرول ایپلیکیشنز۔

رازداری کے تقاضوں پر غور کرنا ضروری ہے: Google Fit Restricted Scopes استعمال کرتا ہے — خصوصی رسائی کے دائرہ کار جنہیں OAuth Verification کے ذریعے علیحدہ ایپلیکیشن تصدیق کی ضرورت ہوتی ہے۔ ڈویلپر کو یہ بیان کرنا ہوگا کہ کون سا ڈیٹا اکٹھا کیا جاتا ہے، اسے کیسے استعمال کیا جاتا ہے اور کب تک ذخیرہ کیا جاتا ہے۔ Google کو رازداری کی پالیسی اور API Services Terms of Service کی تعمیل کی بھی ضرورت ہے۔

عملی ریکارڈنگ کی مثال

ڈیٹا ریکارڈ کرنے کے لیے، قسم، ڈیوائس اور ایپلیکیشن کی وضاحت کرتے ہوئے ایک DataSource بنایا جاتا ہے۔ پھر ایک ٹائم سٹیمپ اور قدروں کے ساتھ ایک DataPoint بنایا جاتا ہے۔ ایک سے زیادہ DataPoints کو DataSet میں یکجا کیا جاتا ہے، جو 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("ڈیٹا محفوظ ہو گیا")
    }