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

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

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

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

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

টেবিল: Google Health API স্টেপ ডেটা টাইপ
ডেটার ধরন উপলভ্য
অপারেশন
সুযোগ
ধাপ
dataType: steps
filter parameter: steps
রেকর্ডের ধরন: ইন্টারভাল
স্টোরেজ সংক্রান্ত সমস্যার সমাধান: ১ মিনিট

মানানসই ডিভাইস

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 সাবস্ক্রিপশন দেখুন।