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

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

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

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

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

সারণি: গুগল হেলথ এপিআই ক্যালোরি ডেটার প্রকারভেদ

ডেটা টাইপ dataType filter প্যারামিটার	রেকর্ড প্রকার	উপলব্ধ অপারেশন	পরিধি	ওয়েবহুক সমর্থন	প্রকৃত শূন্য সমর্থন
সক্রিয় শক্তি ব্যয়িত active-energy-burned active_energy_burned	ব্যবধান	তালিকা, সমন্বয়, একত্রীকরণ, দৈনিক একত্রীকরণ	কার্যকলাপ এবং ফিটনেস
ভিত্তি শক্তি ব্যয়িত basal-energy-burned basal_energy_burned	ব্যবধান	তালিকা করুন, সমন্বয় করুন	কার্যকলাপ এবং ফিটনেস
বেসাল মেটাবলিক রেট basal-metabolic-rate basal_metabolic_rate	নমুনা	তালিকা করুন, সমন্বয় করুন	পুষ্টি

নিম্নলিখিত বিভাগগুলিতে প্রতিটি ডেটা টাইপের জন্য প্রযুক্তিগত বিবরণ দেওয়া হয়েছে, যার মধ্যে 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
}

ভিত্তি শক্তি ব্যয়িত

বেসাল এনার্জি বার্নড হলো একটি নির্দিষ্ট সময় অন্তর ব্যবহারকারীর বিশ্রামকালীন বিপাকের কারণে ব্যয় হওয়া ক্যালোরির পরিমাণ, যা কিলোক্যালোরি ( kcal ) এককে পরিমাপ করা হয়।

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

বেসাল মেটাবলিক রেট

বেসাল মেটাবলিক রেট (বিএমআর) একটি স্বাভাবিক, বিশ্রামরত অবস্থায় শরীরের ব্যয়িত শক্তিকে পরিমাপ করে, যা প্রতিদিন কিলোক্যালরিতে ( kcal/day ) মাপা হয়। যেহেতু সময়ের সাথে সাথে শারীরিক পরিবর্তনের (যেমন ওজন) কারণে এই হার ওঠানামা করে, তাই এপিআই (API) বিএমআর-কে হারের নমুনার একটি সময়-ধারাবাহিক (time series) হিসেবে রেকর্ড করে।

ডেভেলপাররা basal-metabolic-rate স্যাম্পলের rateKcalPerDay ফিল্ডটিকে, ব্যয়িত বেসাল শক্তির দৈনিক রোলআপের দৈনিক প্রতিরূপ হিসেবে বিবেচনা করতে পারেন।

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

{
  "date": {
    "year": 2026,
    "month": 4,
    "day": 20
  },
  "dataSource": { ... },
  "rateKcalPerDay": 1650.0
}

নির্দেশিকা

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

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