أنواع بيانات السعرات الحرارية والطاقة

توفّر Google Health API أنواع بيانات لتتبُّع السعرات الحرارية التي يستهلكها المستخدم والطاقة التي ينفقها. تقيس هذه الأنواع جوانب مختلفة من حرق الطاقة، بما في ذلك إجمالي الطاقة المنفقة والطاقة المحروقة أثناء النشاط ومعدلات الأيض أثناء الراحة (الأساسية).

يُرجى فهم الاختلافات بين أنواع البيانات هذه لتحديد المقاييس المناسبة لتطبيقك.

أنواع البيانات المتوافقة

تتيح واجهة برمجة التطبيقات أنواع البيانات التالية لقياس السعرات الحرارية والطاقة المنفقة:

الجدول: أنواع بيانات السعرات الحرارية في Google Health API

نوع البيانات   dataType   مَعلمة filter	نوع السجلّ	العمليات المتاحة	النطاق	إمكانية استخدام إشعارات الويب	إمكانية استخدام الأصفار الحقيقية
السعرات الحرارية المحروقة أثناء النشاط البدني   active-energy-burned   active_energy_burned	الفاصل الزمني	list وreconcile وrollup وdailyRollup	activity_and_fitness
معدّل الاستقلاب الأساسي   basal-energy-burned   basal_energy_burned	الفاصل الزمني	list وreconcile	activity_and_fitness
معدّل الأيض الأساسي   basal-metabolic-rate   basal_metabolic_rate	نموذج	list وreconcile	nutrition

توفّر الأقسام التالية تفاصيل فنية لكل نوع بيانات، بما في ذلك أمثلة على تمثيل 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).

ملاحظة: لا تتوفّر عمليات التجميع والتجميع اليومي لنوع البيانات هذا. للحصول على قيم معدّل الاستقلاب الأساسي اليومية، استخدِم نوع بيانات "معدّل الأيض الأساسي".

معدّل الأيض الأساسي

يقيس "معدّل الأيض الأساسي" الطاقة التي ينفقها الجسم في حالة الراحة العادية، ويتم قياسها بالكيلو كالوري في اليوم (kcal/day). بما أنّ هذا المعدّل يتقلب مع التغييرات الجسدية (مثل الوزن) بمرور الوقت، تسجِّل واجهة برمجة التطبيقات معدّل الأيض الأساسي كسلسلة زمنية من عيّنات المعدّل.

يمكن للمطوّرين التعامل مع الحقل rateKcalPerDay في عيّنة basal-metabolic-rate على أنّه النظير اليومي للتجميع اليومي لمعدّل الاستقلاب الأساسي.

مثال على تمثيل REST

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

الإرشادات

عند دمج مقاييس السعرات الحرارية والطاقة في تطبيقك، استخدِم هذه الإرشادات:

• نظرة عامة يومية: لعرض إجمالي السعرات الحرارية المنفقة يوميًا، اطلب التجميع اليومي لنوع بيانات total-calories.
• الطاقة المنفقة أثناء النشاط فقط: لتتبُّع السعرات الحرارية المحروقة أثناء تمرين محدّد أو على مدار اليوم باستثناء معدّل الأيض أثناء الراحة، استخدِم طلب البحث active-energy-burned.
• المقاييس الأساسية: لتتبُّع معدّل الأيض أثناء الراحة أو اتجاهات معدّل الأيض الأساسي، استخدِم طلب البحث basal-metabolic-rate للحصول على قيم معدّل الأيض الأساسي. تعامَل مع عيّنات معدّل الأيض الأساسي على أنّها خط أساس يومي لاستهلاك المستخدم للطاقة أثناء الراحة.