Google Health API-এর মাধ্যমে স্টেপ সংক্রান্ত অভিজ্ঞতা ডেভেলপ করা

Google Health API, steps ইন্টারভাল ডেটা টাইপ ব্যবহার করে ব্যবহারকারীর পদক্ষেপ ও অ্যাক্টিভিটি ডেটা ট্র্যাক করে। স্টেপ কাউন্ট হল দৈনিক শারীরিক অ্যাক্টিভিটির একটি মৌলিক পরিমাপ, যা ডেভেলপারদের ফিটনেস অগ্রগতি ট্র্যাক করতে, শক্তি খরচ গণনা করতে এবং ব্যবহারকারী নিজে ইন্টার‌্যাক্ট করতে পারেন এমন দৈনিক অ্যাক্টিভিটির সারাংশ তৈরি করতে সাহায্য করে।

আপনার ব্যবহারকারীদের সেরা অভিজ্ঞতা প্রদান করতে, আপনার অ্যাপ্লিকেশনে স্টেপ কাউন্ট মেট্রিক্স কীভাবে পড়তে এবং গঠন করতে হয় তা বুঝুন।

যেসব ডেটার ধরন কাজ করে

স্টেপ কাউন্ট ট্র্যাক করার জন্য API নিম্নলিখিত ডেটা টাইপ সাপোর্ট করে:

টেবিল: Google Health API স্টেপ ডেটার ধরন

ডেটার ধরন	উপলভ্য অপারেশন	সুযোগ
ধাপ dataType: steps filter parameter: steps রেকর্ডের ধরন: ইন্টারভাল স্টোরেজ সংক্রান্ত সমস্যার সমাধান: ১ মিনিট ওয়েবহুক সংক্রান্ত সহায়তা ট্রু জিরো সংক্রান্ত সহায়তা ধাপ সংক্রান্ত নির্দেশিকা মানানসই ডিভাইস Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

নির্দেশিকা

আপনার অ্যাপে স্টেপ ট্র্যাকিং ইন্টিগ্রেট করার সময়, এই ডিজাইন ও প্রয়োগ সংক্রান্ত নির্দেশিকা অনুসরণ করুন।

গতি ও পেস গণনা করা

Google Health API স্পিড ও গতি হিসেব করতে স্ট্যান্ডার্ড ফর্মুলা ব্যবহার করে:

• স্পিড = distance / time(hour)
• গতি = time(seconds) / distance

অনুরোধে উল্লেখ করা Accept-Language হেডার দূরত্বের ইউনিট নির্ধারণ করে।

দৈনিক ওভারভিউ

ভ্রমণ, টাইম জোন পরিবর্তন বা ডেলাইট সেভিংসের সময় প্রতিদিনের স্টেপ কাউন্ট সঠিকভাবে এগ্রিগেট করতে, ক্লায়েন্ট-সাইড সময়সীমা গণনা করবেন না। পরিবর্তে, dailyRollUp এন্ডপয়েন্ট কোয়েরি করুন যা UTC অফসেট ব্যবহার করে অটোমেটিক ফিজিক্যাল ডেটা গ্যাপ রিকনসাইল করে। রোলআপ একটি StepsRollupValue প্রদান করে যার মধ্যে countSum ফিল্ড থাকে, যা অনুরোধ করা দিনের জন্য মোট জমা হওয়া ধাপের সংখ্যা দেখায়। আরও জানতে, মোট ডেটা সংক্রান্ত গাইডে ক্যালেন্ডার দিন জুড়ে মোট ডেটা দেখুন।

ইউজার ইন্টারফেস আঁকা (রিকনসিলিয়েশন)

স্টেপ ডেটা দেখানোর জন্য ইউজার ইন্টারফেস এলিমেন্ট তৈরি করার সময়, reconcile এন্ডপয়েন্ট ব্যবহার করুন। একাধিক ডেটা সোর্স (যেমন, স্মার্টওয়াচ ও মোবাইল ফোন) একই সময়ে পদক্ষেপ রেকর্ড করলে, reconcile এন্ডপয়েন্ট সমস্যার সমাধান করে এবং স্ট্রিম মার্জ করে একটি, রিকনসাইল করা ডেটা স্ট্রিম ফিরিয়ে দেয়।

কানেক্ট করা ডিভাইস সিঙ্ক থেকে ওভারল্যাপ করা ইন্টারভাল এবং টাইমস্ট্যাম্পের পরিবর্তনশীলতা ম্যানেজ করার ব্যাপারে তথ্যের জন্য, ডেটা ম্যানেজমেন্ট গাইড দেখুন।

ইন্ট্রাডে ট্র্যাকিং ও হিস্টোগ্রাম

সারাদিন ধরে ব্যবহারকারীর অ্যাক্টিভিটির বিস্তারিত বিবরণ দেখানোর জন্য (যেমন চার্ট ও গ্রাফ):

• ঘণ্টা বা মিনিট স্টেপ হিস্টোগ্রাম: rollUp এন্ডপয়েন্ট কোয়েরি করুন, windowSize প্যারামিটার ব্যবহার করে সময়সীমা (যেমন, ১ মিনিটের জন্য 60s বা ১ ঘণ্টার জন্য 3600s) উল্লেখ করুন। কারণ স্টেপ ডেটা ১-মিনিট (60s) বিরতিতে রেকর্ড করা হয়, windowSize কমপক্ষে 60s-এ সেট করুন। এক মিনিটের কম সময়ের উইন্ডো সাইজ (যেমন 10s বা 30s) সহ অনুরোধগুলি এক মিনিটের মোট সময়কে ভাগ করে না, পুরো মিনিটের গণনা প্রথম ম্যাচিং সাব-বাকেটে রাখে। বিস্তারিত জানতে, রোলআপ উইন্ডো ও স্টোরেজ রেজোলিউশন দেখুন।
• সব স্টেপ রেকর্ড: সবচেয়ে গ্র্যানুলার, র স্টেপ রেকর্ড ফেচ করতে list এন্ডপয়েন্ট ব্যবহার করুন।

rollUp, dailyRollUp এবং reconcile এন্ডপয়েন্ট dataSourceFamily প্যারামিটার গ্রহণ করে, যা আপনাকে নির্দিষ্ট সোর্স গ্রুপ থেকে ডেটা ফিল্টার করার অনুমতি দেয়। আরও বিবরণ এবং ব্যবহারের উদাহরণের জন্য, ডেটা সোর্স ফ্যামিলি অনুযায়ী ফিল্টার করুন বিভাগ থেকে ফিল্টার ডেটা গাইড দেখুন।

ওয়েবহুক ব্যবহার করে রিয়েল-টাইম সিঙ্ক

নতুন স্টেপ ডেটা ইমপোর্ট বা সিঙ্ক করা হলে রিয়েল টাইমে বিজ্ঞপ্তি পেতে steps ডেটা টাইপ কালেকশনে সাবস্ক্রাইব করুন। REST এন্ডপয়েন্ট পোল করার পরিবর্তে, এইসব ওয়েবহুক বিজ্ঞপ্তির উত্তরে ক্লায়েন্ট-সাইড ড্যাশবোর্ড ডায়নামিকভাবে আপডেট করুন। সাবস্ক্রিপশন কীভাবে সেট-আপ করতে হয় সেই সম্পর্কে আরও জানতে, Webhook সাবস্ক্রিপশন দেখুন।