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

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

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

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

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

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

סוג הנתונים   dataType הפרמטר   filter	סוג הרשומה	פעולות זמינות	היקף	תמיכה ב-Webhook	תמיכה באפסים אמיתיים
האנרגיה הפעילה שנשרפה   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). הערך מחושב על סמך הוצאת אנרגיה פעילה וקצב חילוף החומרים הבסיסי של המשתמש.

הערה: שאילתות של נתונים מסוג total-calories חייבות לכלול מסנן של מרווח זמן (כמו total_calories.interval.start_time או total_calories.interval.civil_start_time). הטווח המקסימלי של השאילתות האלה הוא 14 ימים.

דוגמה לשאילתה

כדי לשלוח שאילתה לסוג הנתונים 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
}

אנרגיה בסיסית שנשרפה

המדד 'קלוריות בסיסיות שנשרפו' מייצג את הקלוריות שנשרפו כתוצאה מהמטבוליזם של המשתמש במצב מנוחה, במרווחי זמן, ונמדד בקילוקלוריות (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 כאל נתון בסיסי יומי לצריכת האנרגיה במנוחה של המשתמש.