Google Fit — यह क्या है, प्लेटफ़ॉर्म आर्किटेक्चर और API

Google Fit क्या है?

Google Fit — Google द्वारा 2014 में I/O सम्मेलन में लॉन्च किया गया स्वास्थ्य प्रबंधन प्लेटफ़ॉर्म है। प्लेटफ़ॉर्म शारीरिक गतिविधि डेटा को पढ़ने और लिखने के लिए एक एकीकृत API प्रदान करता है, जिससे ऐप्लिकेशन Google क्लाउड में केंद्रीय भंडारण के माध्यम से जानकारी साझा कर सकते हैं।

मालिकाना समाधानों के विपरीत, Google Fit Android ऑपरेटिंग सिस्टम और iOS पर REST API के माध्यम से काम करता है। उपयोगकर्ता फ़िटनेस बैंड, स्मार्ट घड़ियाँ और गतिविधि ट्रैकिंग ऐप्लिकेशन कनेक्ट कर सकता है, और 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 कंसोल के माध्यम से कस्टम DataType बनाए जा सकते हैं।

प्लेटफ़ॉर्म दो रिकॉर्डिंग मोड का समर्थन करता है: सक्रिय — ऐप्लिकेशन स्पष्ट रूप से HistoryClient.insertData() को कॉल करता है, और निष्क्रिय — RecordingClient के माध्यम से, जो पृष्ठभूमि में डेटा संग्रह के लिए सदस्यता लेता है। निष्क्रिय मोड फ़िटनेस ऐप्लिकेशन के लिए सुविधाजनक है: उपयोगकर्ता एक बार ऐप्लिकेशन शुरू करता है, और Google Fit स्वचालित रूप से ऐप्लिकेशन के न्यूनतम होने पर प्रोसेसर के निरंतर उपयोग के बिना कदम, कैलोरी और दूरी एकत्र करता है।

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 कंसोल को कॉन्फ़िगर करना आवश्यक है — एक प्रोजेक्ट बनाएँ, 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 बनाया जाता है। कई DataPoint को 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("डेटा सहेज लिया गया")
    }