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

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

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

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

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

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

نوع داده 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

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

انرژی فعال سوزانده شده، انرژی سوزانده شده توسط کاربر در طول دوره‌های فعالیت را نشان می‌دهد، به استثنای هزینه انرژی پایه آنها که بر حسب کیلوکالری ( 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 را جستجو کنید.