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("ডেটা সংরক্ষিত")
    }