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

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

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

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

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

جدول: انواع داده‌های کالری API سلامت گوگل
نوع داده
dataType
پارامتر filter		 موجود است
عملیات		 دامنه
انرژی فعال سوزانده شده
active-energy-burned
active_energy_burned
نوع رکورد: فاصله‌ای
 فهرست کردن، تطبیق دادن، جمع کردن، جمع کردن روزانه .activity_and_fitness.readonly
.activity_and_fitness.writeonly
کل کالری
total-calories
total_calories
نوع رکورد: فاصله‌ای

دستگاه‌های سازگار

 رول‌آپ، رول‌آپ روزانه .activity_and_fitness.readonly
.activity_and_fitness.writeonly

بخش‌های زیر جزئیات فنی مربوط به هر نوع داده، از جمله نمونه‌های نمایش 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

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

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

مثال نمایش REST 

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

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

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

  • مرور کلی روزانه: برای نمایش کل کالری مصرفی روزانه، درخواست جمع‌آوری روزانه‌ی نوع داده‌ی total-calories را بدهید.
  • هزینه فقط بر اساس فعالیت: برای پیگیری کالری‌های سوزانده شده در طول یک تمرین خاص یا در طول روز بدون در نظر گرفتن میزان متابولیسم در حالت استراحت، active-energy-burned را جستجو کنید.
  • نگاشت‌های قدیمی: اگر از Fitbit Web API مهاجرت می‌کنید، برای جزئیات بیشتر در مورد نحوه نگاشت فیلدهای قدیمی (مانند activityCalories ، caloriesBMR و caloriesOut ) به انواع داده‌های جدید، به بخش نگاشت‌های نوع داده Fitbit Web API به Google Health API در راهنمای مهاجرت مراجعه کنید.
قبلی
سازگاری دستگاه
بعدی
علائم حیاتی