סוגי נתונים של קלוריות ואנרגיה

‫Google Health API מספק סוגי נתונים שעוקבים אחרי צריכת הקלוריות והוצאת האנרגיה של המשתמש. הסוגים האלה מודדים היבטים שונים של שריפת אנרגיה, כולל סך ההוצאה האנרגטית, שריפת אנרגיה בזמן פעילות וקצב חילוף חומרים במנוחה (בסיסי).

חשוב להבין את ההבדלים בין סוגי הנתונים האלה כדי לקבוע אילו מדדים מתאימים לאפליקציה שלכם.

סוגי נתונים נתמכים

ה-API תומך בסוגי הנתונים הבאים למדידת קלוריות והוצאת אנרגיה:

טבלה: סוגי נתונים של קלוריות ב-Google Health API

סוג הנתונים   dataType הפרמטר   filter	סוג הרשומה	פעולות זמינות	היקף	תמיכה ב-Webhook	תמיכה באפסים אמיתיים
Active Energy Burned   active-energy-burned   active_energy_burned	מרווח	list, reconcile, rollup, dailyRollup	activity_and_fitness
Basal Energy Burned   basal-energy-burned   basal_energy_burned	מרווח	רשימה, התאמה	activity_and_fitness
קצב חילוף החומרים הבסיסי   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 (קצב חילוף חומרים בסיסי).

קצב חילוף החומרים הבסיסי

קצב חילוף החומרים הבסיסי (BMR) הוא מדד של האנרגיה שהגוף מוציא במצב מנוחה רגיל, והוא נמדד בקילוקלוריות ליום (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.
• מדדים בסיסיים: כדי לעקוב אחרי קצב חילוף החומרים במנוחה או אחרי מגמות של קצב חילוף החומרים הבסיסי, שולחים שאילתה אל basal-metabolic-rate לגבי ערכי קצב חילוף החומרים הבסיסי. התייחסות לדגימות של BMR כאל נתון בסיסי יומי לצריכת האנרגיה במנוחה של המשתמש.