ক্যালোরি এবং শক্তির ডেটা প্রকার

গুগল হেলথ এপিআই এমন ডেটা টাইপ সরবরাহ করে যা একজন ব্যবহারকারীর ক্যালোরি এবং শক্তি ব্যয়ের হিসাব রাখে। এই টাইপগুলো শক্তি খরচের বিভিন্ন দিক পরিমাপ করে, যার মধ্যে রয়েছে মোট খরচ, সক্রিয় খরচ এবং বিশ্রামকালীন (বেসাল) মেটাবলিক রেট।

আপনার অ্যাপ্লিকেশনের জন্য কোন মেট্রিকগুলো উপযুক্ত, তা নির্ধারণ করতে এই ডেটা টাইপগুলোর মধ্যে পার্থক্যগুলো বুঝুন।

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

ক্যালোরি এবং শক্তি ব্যয় পরিমাপের জন্য এপিআই নিম্নলিখিত ডেটা টাইপগুলো সমর্থন করে:

সারণি: গুগল হেলথ এপিআই ক্যালোরি ডেটার প্রকারভেদ
ডেটা টাইপ
dataType
filter প্যারামিটার		 রেকর্ড
প্রকার		 উপলব্ধ
অপারেশন		 পরিধি ওয়েবহুক
সমর্থন		 প্রকৃত শূন্য
সমর্থন
সক্রিয় শক্তি ব্যয়িত
active-energy-burned
active_energy_burned		 ব্যবধান তালিকা, সমন্বয়, একত্রীকরণ, দৈনিক একত্রীকরণ কার্যকলাপ এবং ফিটনেস
মোট ক্যালোরি
total-calories
total_calories		 ব্যবধান রোলআপ, দৈনিক রোলআপ কার্যকলাপ এবং ফিটনেস

নিম্নলিখিত বিভাগগুলিতে প্রতিটি ডেটা টাইপের জন্য প্রযুক্তিগত বিবরণ দেওয়া হয়েছে, যার মধ্যে REST উপস্থাপনার উদাহরণ এবং নির্দিষ্ট ইন্টিগ্রেশন সীমাবদ্ধতা অন্তর্ভুক্ত রয়েছে।

মোট ক্যালোরি

টোটাল ক্যালোরিজ হলো একটি রিড-অনলি ডিরাইভড ডেটা টাইপ যা একজন ব্যবহারকারীর ব্যয় করা সমস্ত শক্তির হিসাব রাখে, যার মধ্যে বেসাল মেটাবলিজম এবং সক্রিয় শক্তি অন্তর্ভুক্ত। এটি কিলোক্যালোরি ( kcal ) এককে পরিমাপ করা হয়। এই মানটি সক্রিয় শক্তি ব্যয় এবং ব্যবহারকারীর বেসাল মেটাবলিক রেট থেকে গণনা করা হয়।

total-calories ডেটা টাইপের জন্য করা কোয়েরিতে অবশ্যই একটি সময় ব্যবধান ফিল্টার অন্তর্ভুক্ত করতে হবে (যেমন total_calories.interval.start_time অথবা total_calories.interval.civil_start_time )। এই কোয়েরিগুলোর জন্য সর্বোচ্চ সীমা হলো ১৪ দিন।

কোয়েরির উদাহরণ

total-calories ডেটা টাইপটি কোয়েরি করতে, একটি ইন্টারভাল ফিল্টার সহ list এন্ডপয়েন্টে একটি অনুরোধ পাঠান:

অনুরোধ 

GET https://health.googleapis.com/v4/users/me/dataTypes/total-calories/dataPoints?filter=total_calories.interval.start_time >= "2026-04-20T00:00:00Z" AND total_calories.interval.start_time < "2026-04-21T00:00:00Z"
Authorization: Bearer access-token
Accept: application/json

সক্রিয় শক্তি ব্যয়িত

সক্রিয় শক্তি ব্যয় (Active Energy Burned) বলতে ব্যবহারকারীর কার্যকলাপের সময়কালে ব্যয়িত শক্তিকে বোঝায়, যা তার স্বাভাবিক শক্তি ব্যয় (basal energy expenditure) ব্যতীত কিলোক্যালরিতে ( kcal ) পরিমাপ করা হয়।

REST উপস্থাপনার উদাহরণ 

{
  "startTime": "2026-04-20T08:00:00Z",
  "startUtcOffset": "0s",
  "endTime": "2026-04-20T08:30:00Z",
  "endUtcOffset": "0s",
  "dataSource": { ... },
  "kcal": 150.0
}

নির্দেশিকা

আপনার অ্যাপে ক্যালোরি এবং শক্তির মেট্রিক অন্তর্ভুক্ত করার সময়, এই নির্দেশিকাগুলি ব্যবহার করুন:

  • দৈনিক সার্বিক চিত্র: দৈনিক মোট ক্যালোরি ব্যয়ের পরিমাণ দেখতে, total-calories ডেটা টাইপের দৈনিক সারসংক্ষেপের জন্য অনুরোধ করুন।
  • শুধুমাত্র কার্যকলাপ-জনিত ব্যয়: বিশ্রামকালীন বিপাকীয় হার (resting metabolic rate) বাদ দিয়ে কোনো নির্দিষ্ট ওয়ার্কআউটের সময় বা সারা দিন ধরে কত ক্যালোরি খরচ হয়েছে তা ট্র্যাক করতে, active-energy-burned ' কোয়েরিটি ব্যবহার করুন।
পূর্ববর্তী
ডেটা প্রকার সূচক
পরবর্তী
ওয়ার্কআউট