انواع داده‌های کالری و انرژی

رابط برنامه‌نویسی کاربردی گوگل هلث (Google Health API) انواع داده‌هایی را ارائه می‌دهد که کالری و میزان مصرف انرژی کاربر را ردیابی می‌کنند. این انواع داده‌ها جنبه‌های مختلف مصرف انرژی، از جمله کل مصرف، مصرف فعال و میزان متابولیسم پایه (استراحت) را اندازه‌گیری می‌کنند.

تفاوت‌های بین این نوع داده‌ها را درک کنید تا مشخص کنید کدام معیارها برای برنامه شما مناسب هستند.

انواع داده پشتیبانی شده

این API از انواع داده‌های زیر برای اندازه‌گیری کالری و مصرف انرژی پشتیبانی می‌کند:

جدول: انواع داده‌های کالری API سلامت گوگل

نوع داده dataType پارامتر filter	رکورد نوع	موجود است عملیات	محدوده	وب‌هوک پشتیبانی	صفرهای واقعی پشتیبانی
انرژی فعال سوزانده شده active-energy-burned active_energy_burned	فاصله	فهرست کردن، تطبیق دادن، جمع کردن، جمع کردن روزانه	فعالیت_و_تناسب_اندام
انرژی پایه سوزانده شده basal-energy-burned basal_energy_burned	فاصله	فهرست کردن، تطبیق دادن	فعالیت_و_تناسب_اندام
میزان متابولیسم پایه basal-metabolic-rate basal_metabolic_rate	نمونه	فهرست کردن، تطبیق دادن	تغذیه

بخش‌های زیر جزئیات فنی مربوط به هر نوع داده، از جمله نمونه‌های نمایش REST و محدودیت‌های خاص ادغام را ارائه می‌دهند.

کل کالری

کالری کل یک نوع داده مشتق شده فقط خواندنی است که تمام انرژی مصرف شده توسط کاربر، از جمله متابولیسم پایه و انرژی فعال، را که بر حسب کیلوکالری ( kcal ) اندازه‌گیری می‌شود، ردیابی می‌کند. این مقدار از میزان مصرف انرژی فعال و میزان متابولیسم پایه کاربر محاسبه می‌شود.

انرژی فعال سوزانده شده

انرژی فعال سوزانده شده، انرژی سوزانده شده توسط کاربر در طول دوره‌های فعالیت را نشان می‌دهد، به استثنای هزینه انرژی پایه آنها که بر حسب کیلوکالری ( kcal ) اندازه‌گیری می‌شود.

مثال نمایش REST

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

انرژی پایه سوزانده شده

انرژی پایه سوزانده شده، کالری سوزانده شده به دلیل متابولیسم استراحت کاربر در فواصل زمانی مختلف را نشان می‌دهد که با واحد کیلوکالری ( kcal ) اندازه‌گیری می‌شود.

نکته: عملیات جمع‌بندی و جمع‌بندی روزانه برای این نوع داده در دسترس نیست. برای به دست آوردن مقادیر انرژی پایه روزانه، از نوع داده Basal Metabolic Rate استفاده کنید.

میزان متابولیسم پایه

میزان متابولیسم پایه، انرژی مصرف شده توسط بدن را در حالت استراحت عادی، بر حسب کیلوکالری در روز ( kcal/day ) اندازه‌گیری می‌کند. از آنجا که این میزان با به‌روزرسانی‌های فیزیکی (مانند وزن) در طول زمان نوسان می‌کند، API، BMR را به عنوان یک سری زمانی از نمونه‌های نرخ ثبت می‌کند.

توسعه‌دهندگان می‌توانند فیلد rateKcalPerDay را در یک نمونه basal-metabolic-rate به عنوان معادل روزانه‌ی جمع‌آوری روزانه‌ی انرژی پایه‌ی سوزانده شده در نظر بگیرند.

مثال نمایش REST

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

دستورالعمل‌ها

هنگام ادغام معیارهای کالری و انرژی در برنامه خود، از این دستورالعمل‌ها استفاده کنید:

• مرور کلی روزانه: برای نمایش کل کالری مصرفی روزانه، درخواست جمع‌آوری روزانه‌ی نوع داده‌ی total-calories را بدهید.
• هزینه فقط بر اساس فعالیت: برای پیگیری کالری‌های سوزانده شده در طول یک تمرین خاص یا در طول روز بدون در نظر گرفتن میزان متابولیسم در حالت استراحت، active-energy-burned را جستجو کنید.
• معیارهای پایه: برای ردیابی میزان متابولیسم پایه یا روند متابولیسم پایه، مقادیر BMR را از basal-metabolic-rate جستجو کنید. نمونه‌های BMR را به عنوان مبنای روزانه برای مصرف انرژی در حالت استراحت کاربر در نظر بگیرید.