গুগল হেলথ এপিআই steps ইন্টারভ্যাল’ ডেটা টাইপ ব্যবহার করে ব্যবহারকারীর পদক্ষেপ এবং কার্যকলাপের ডেটা ট্র্যাক করে। পদক্ষেপের সংখ্যা দৈনন্দিন শারীরিক কার্যকলাপের একটি মৌলিক পরিমাপ, যা ডেভেলপারদের ফিটনেসের অগ্রগতি ট্র্যাক করতে, শক্তি ব্যয় গণনা করতে এবং ব্যবহারকারীদের জন্য দৈনন্দিন কার্যকলাপের সারাংশ তৈরি করতে সহায়তা করে।
আপনার ব্যবহারকারীদের সর্বোত্তম অভিজ্ঞতা প্রদানের জন্য, আপনার অ্যাপ্লিকেশনে স্টেপ কাউন্ট মেট্রিক্স কীভাবে পড়তে ও সাজাতে হয় তা বুঝুন।
সমর্থিত ডেটা প্রকার
ধাপ সংখ্যা ট্র্যাক করার জন্য এপিআই নিম্নলিখিত ডেটা টাইপ সমর্থন করে:
| ডেটা টাইপ | উপলব্ধ অপারেশন | পরিধি |
|---|---|---|
| পদক্ষেপ ডেটাটাইপ: stepsফিল্টার প্যারামিটার: steps রেকর্ডের ধরণ: ব্যবধান সামঞ্জস্যপূর্ণ ডিভাইস
| তালিকা, সমন্বয়, একত্রীকরণ, দৈনিক একত্রীকরণ | .activity_and_fitness.readonly.activity_and_fitness.writeonly |
নিম্নলিখিত বিভাগগুলিতে steps ডেটা টাইপের প্রযুক্তিগত বিবরণ দেওয়া হয়েছে, যার মধ্যে REST উপস্থাপনার উদাহরণ এবং ইন্টিগ্রেশন নির্দেশিকা অন্তর্ভুক্ত রয়েছে।
প্রয়োজনীয় পরিধি
এই ডেটা টাইপটি অ্যাক্সেস করতে, আপনার অ্যাপকে অবশ্যই নিম্নলিখিত OAuth স্কোপগুলির জন্য অনুরোধ করতে হবে:
- পড়ুন :
https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly - লিখুন :
https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly
নির্দেশিকা
আপনার অ্যাপে পদক্ষেপ ট্র্যাকিং যুক্ত করার সময়, এই ডিজাইন এবং বাস্তবায়ন নির্দেশিকাগুলো অনুসরণ করুন।
দৈনিক সংক্ষিপ্ত বিবরণ
ভ্রমণ, টাইম জোন পরিবর্তন বা ডেলাইট সেভিংসের কারণে দৈনিক পদক্ষেপের সংখ্যা সঠিকভাবে একত্রিত করতে, ক্লায়েন্ট-সাইডে সময়কাল গণনা করবেন না। এর পরিবর্তে, dailyRollUp এন্ডপয়েন্টটি কোয়েরি করুন, যা UTC অফসেট ব্যবহার করে স্বয়ংক্রিয়ভাবে ভৌত ডেটার ফাঁক পূরণ করে। রোলআপটি একটি StepsRollupValue রিটার্ন করে, যাতে countSum ফিল্ডটি থাকে, যা অনুরোধ করা দিনের জন্য মোট সঞ্চিত পদক্ষেপের সংখ্যা নির্দেশ করে।
ব্যবহারকারী ইন্টারফেস অঙ্কন (সমন্বয়)
স্টেপ ডেটা দেখানোর জন্য ইউজার ইন্টারফেস এলিমেন্ট তৈরি করার সময়, reconcile এন্ডপয়েন্ট ব্যবহার করুন। যদি একাধিক ডেটা সোর্স (যেমন একটি স্মার্টওয়াচ এবং একটি মোবাইল ফোন) একই সময়ে স্টেপ রেকর্ড করে থাকে, তাহলে reconcile এন্ডপয়েন্ট দ্বন্দ্ব সমাধান করে এবং স্ট্রিমগুলিকে একত্রিত করে একটি একক, সমন্বিত ডেটা স্ট্রিম ফেরত দেয়।
ইন্ট্রাডে ট্র্যাকিং এবং হিস্টোগ্রাম
দিনব্যাপী ব্যবহারকারীর কার্যকলাপের বিস্তারিত বিবরণ (যেমন চার্ট এবং গ্রাফ) প্রদর্শন করতে:
- ঘণ্টাভিত্তিক স্টেপ হিস্টোগ্রাম:
windowSizeপ্যারামিটার ব্যবহার করে সময়কাল (যেমন ১ ঘণ্টার জন্য3600s) উল্লেখ করেrollUpএন্ডপয়েন্টে কোয়েরি করুন। - সমস্ত ধাপের রেকর্ড: সবচেয়ে সুনির্দিষ্ট ও মূল ধাপের রেকর্ডগুলো পেতে
listএন্ডপয়েন্টটি ব্যবহার করুন।
rollUp , dailyRollUp , এবং reconcile এন্ডপয়েন্টগুলো dataSourceFamily প্যারামিটার গ্রহণ করে, যা আপনাকে নির্দিষ্ট সোর্স গ্রুপ থেকে ডেটা ফিল্টার করার সুযোগ দেয়। আরও বিস্তারিত তথ্য এবং ব্যবহারের উদাহরণের জন্য, এন্ডপয়েন্টস গাইডের 'ডেটা সোর্স ফ্যামিলি অনুসারে ফিল্টার এবং অ্যাগ্রিগেট' অংশটি দেখুন।
ওয়েবহুক ব্যবহার করে রিয়েল-টাইম সিঙ্ক
নতুন স্টেপ ডেটা ইম্পোর্ট বা সিঙ্ক্রোনাইজ করা হলে রিয়েল টাইমে নোটিফিকেশন পেতে steps ডেটা টাইপ কালেকশনে সাবস্ক্রাইব করুন। REST এন্ডপয়েন্ট পোলিং করার পরিবর্তে, এই ওয়েবহুক নোটিফিকেশনগুলোর প্রতিক্রিয়ায় ক্লায়েন্ট-সাইড ড্যাশবোর্ডগুলো ডায়নামিকভাবে আপডেট করুন। সাবস্ক্রিপশন কীভাবে সেট আপ করতে হয় সে সম্পর্কে বিস্তারিত জানতে, ওয়েবহুক সাবস্ক্রিপশন দেখুন।
প্রকৃত শূন্যগুলি পরিচালনা করুন
গুগল হেলথ এপিআই নিষ্ক্রিয়তার সময়কাল নির্ধারণের জন্য প্রকৃত শূন্য ব্যবহার করে। যদি কোনো ব্যবহারকারী একটি নির্দিষ্ট সময়কালে ট্র্যাকার পরে থাকেন কিন্তু না হাঁটেন, তাহলে এপিআই সেই সময়কালের জন্য এমন একটি রেকর্ড ফেরত দেয় যাতে সাধারণ ডেটা সোর্স এবং টাইমস্ট্যাম্প মেটাডেটা থাকে, কিন্তু ' count প্রপার্টিটি বাদ দেওয়া হয়।
এর মাধ্যমে আপনি পার্থক্য করতে পারবেন:
- কব্জিতে স্থির থাকার সময়কাল: ব্যবহারকারী ডিভাইসটি পরে আছেন কিন্তু হাঁটছেন না। এটি
count' প্রপার্টি ছাড়া রেকর্ড ফেরত দেয় (যা শূন্য পদক্ষেপ হিসাবে গণ্য করা হয়)। - কব্জি-বহির্ভূত সময়কাল: ব্যবহারকারী ডিভাইসটি পরিধান করছেন না। এর ফলে কোনো রেকর্ড পাওয়া যায় না এবং ডেটাতে বড় ধরনের ফাঁক তৈরি হয়।
আরও বিস্তারিত তথ্যের জন্য ডেটার উপস্থিতি এবং প্রকৃত শূন্য সংক্রান্ত নির্দেশিকাটি দেখুন।