গুগল হেলথ এপিআই ব্যবহার করে ধাপে ধাপে অভিজ্ঞতা অর্জন করুন

গুগল হেলথ এপিআই steps ইন্টারভ্যাল’ ডেটা টাইপ ব্যবহার করে ব্যবহারকারীর পদক্ষেপ এবং কার্যকলাপের ডেটা ট্র্যাক করে। পদক্ষেপের সংখ্যা দৈনন্দিন শারীরিক কার্যকলাপের একটি মৌলিক পরিমাপ, যা ডেভেলপারদের ফিটনেসের অগ্রগতি ট্র্যাক করতে, শক্তি ব্যয় গণনা করতে এবং ব্যবহারকারীদের জন্য দৈনন্দিন কার্যকলাপের সারাংশ তৈরি করতে সহায়তা করে।

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

সমর্থিত ডেটা প্রকার

ধাপ সংখ্যা ট্র্যাক করার জন্য এপিআই নিম্নলিখিত ডেটা টাইপ সমর্থন করে:

সারণি: গুগল হেলথ এপিআই স্টেপস ডেটা টাইপ

ডেটা টাইপ	উপলব্ধ অপারেশন	পরিধি
পদক্ষেপ ডেটাটাইপ: steps ফিল্টার প্যারামিটার: steps রেকর্ডের ধরণ: ব্যবধান স্টোরেজ রেজোলিউশন: ১ মিনিট ওয়েবহুক সাপোর্ট, ট্রু জিরো সাপোর্ট, ধাপ নির্দেশিকা সামঞ্জস্যপূর্ণ ডিভাইস ফিটবিট এয়ার ফিটবিট আল্টা ফিটবিট আল্টা এইচআর ফিটবিট ব্লেজ ফিটবিট চার্জ ২ ফিটবিট চার্জ ৩ ফিটবিট চার্জ ৪ ফিটবিট চার্জ ৫ ফিটবিট চার্জ ৬ ফিটবিট ফ্লেক্স ২ ফিটবিট ইন্সপায়ার ফিটবিট ইন্সপায়ার ২ ফিটবিট ইন্সপায়ার ৩ ফিটবিট ইন্সপায়ার এইচআর ফিটবিট আয়নিক ফিটবিট লাক্স ফিটবিট মোবাইলট্র্যাক পিক্সেল ওয়াচ পিক্সেল ওয়াচ ২ পিক্সেল ওয়াচ ৩ পিক্সেল ওয়াচ ৪ ফিটবিট সেন্স ফিটবিট সেন্স ২ ফিটবিট ভার্সা ফিটবিট ভার্সা ২ ফিটবিট ভার্সা ৩ ফিটবিট ভার্সা ৪ ফিটবিট ভার্সা লাইট	তালিকা, সমন্বয়, একত্রীকরণ, দৈনিক একত্রীকরণ	.activity_and_fitness.readonly .activity_and_fitness.writeonly

নির্দেশিকা

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

গতি এবং বেগ গণনা

গুগল হেলথ এপিআই গতি ও বেগ গণনা করতে প্রচলিত সূত্র ব্যবহার করে:

• গতি = distance / time(hour)
• গতি = time(seconds) / distance

অনুরোধে নির্দিষ্ট করা Accept-Language হেডারটি দূরত্বের একক নির্ধারণ করে।

দৈনিক সংক্ষিপ্ত বিবরণ

ভ্রমণ, টাইম জোন পরিবর্তন বা ডেলাইট সেভিংসের কারণে দৈনিক পদক্ষেপের সংখ্যা সঠিকভাবে একত্রিত করতে, ক্লায়েন্ট-সাইডে সময়কাল গণনা করবেন না। এর পরিবর্তে, dailyRollUp এন্ডপয়েন্টটি কোয়েরি করুন, যা UTC অফসেট ব্যবহার করে স্বয়ংক্রিয়ভাবে ভৌত ডেটার ফাঁক পূরণ করে। রোলআপটি একটি StepsRollupValue রিটার্ন করে, যাতে countSum ফিল্ডটি থাকে, যা অনুরোধ করা দিনের জন্য মোট সঞ্চিত পদক্ষেপের সংখ্যা নির্দেশ করে।

ব্যবহারকারী ইন্টারফেস অঙ্কন (সমন্বয়)

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

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

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

দিনব্যাপী ব্যবহারকারীর কার্যকলাপের বিস্তারিত বিবরণ (যেমন চার্ট এবং গ্রাফ) প্রদর্শন করতে:

• ঘণ্টা বা মিনিটের স্টেপ হিস্টোগ্রামের জন্য: windowSize প্যারামিটার ব্যবহার করে সময়কাল (যেমন ১ মিনিটের জন্য 60s বা ১ ঘণ্টার জন্য 3600s ) উল্লেখ করে ` rollUp এন্ডপয়েন্টে কোয়েরি করুন। যেহেতু স্টেপ ডেটা ১-মিনিটের ( 60s ) ব্যবধানে রেকর্ড করা হয়, তাই windowSize কমপক্ষে 60s সেট করুন। সাব-মিনিট উইন্ডো সাইজের (যেমন 10s বা 30s ) অনুরোধগুলো পৃথক মিনিটের মোট সংখ্যাকে ভাগ করে না, বরং পুরো মিনিটের গণনাকে প্রথম মিলে যাওয়া সাব-বাকেটে রাখে। বিস্তারিত জানতে, `Rollup window size and underlying storage resolution` দেখুন।
• সমস্ত ধাপের রেকর্ড: সবচেয়ে সুনির্দিষ্ট ও মূল ধাপের রেকর্ডগুলো পেতে list এন্ডপয়েন্টটি ব্যবহার করুন।

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

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

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

প্রকৃত শূন্যগুলি পরিচালনা করুন

গুগল হেলথ এপিআই নিষ্ক্রিয়তার সময়কাল নির্ধারণের জন্য প্রকৃত শূন্য ব্যবহার করে। যদি কোনো ব্যবহারকারী একটি নির্দিষ্ট সময়কালে ট্র্যাকার পরে থাকেন কিন্তু না হাঁটেন, তাহলে এপিআই সেই সময়কালের জন্য এমন একটি রেকর্ড ফেরত দেয় যাতে সাধারণ ডেটা সোর্স এবং টাইমস্ট্যাম্প মেটাডেটা থাকে, কিন্তু ' count প্রপার্টিটি বাদ দেওয়া হয়।

এর মাধ্যমে আপনি পার্থক্য করতে পারবেন:

• কব্জিতে স্থির থাকার সময়কাল: ব্যবহারকারী ডিভাইসটি পরে আছেন কিন্তু হাঁটছেন না। এটি count ' প্রপার্টি ছাড়া রেকর্ড ফেরত দেয় (যা শূন্য পদক্ষেপ হিসাবে গণ্য করা হয়)।
• কব্জি-বহির্ভূত সময়কাল: ব্যবহারকারী ডিভাইসটি পরিধান করছেন না। এর ফলে কোনো রেকর্ড পাওয়া যায় না এবং ডেটাতে বড় ধরনের ফাঁক তৈরি হয়।

আরও বিস্তারিত তথ্যের জন্য ডেটার উপস্থিতি এবং প্রকৃত শূন্য সংক্রান্ত নির্দেশিকাটি দেখুন।