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

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

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

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

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

טבלה: סוגי נתונים של קלוריות ב-Google Health API
סוג הנתונים
  dataType הפרמטר
  filter		 סוג
הרשומה		 פעולות
זמינות		 היקף תמיכה ב-Webhook
 תמיכה בערכים אפסיים אמיתיים
האנרגיה הפעילה שנשרפה
  active-energy-burned
  active_energy_burned 		מרווח list, reconcile, rollup, dailyRollup .activity_and_fitness.readonly
.activity_and_fitness.writeonly
סה"כ קלוריות
  total-calories
  total_calories 		מרווח סיכום, dailyRollup .activity_and_fitness.readonly
.activity_and_fitness.writeonly

בקטעים הבאים מפורטים פרטים טכניים לגבי כל סוג נתונים, כולל דוגמאות לייצוג 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
}

הנחיות

כשמשלבים מדדים של קלוריות ואנרגיה באפליקציה, חשוב לפעול לפי ההנחיות הבאות:

  • סקירה כללית יומית: כדי להציג את ההוצאה הכוללת של קלוריות ביום, צריך לבקש את סיכום הנתונים היומי של סוג הנתונים total-calories.
  • הוצאת אנרגיה רק מפעילות: כדי לעקוב אחרי קלוריות שנשרפו במהלך אימון ספציפי או במהלך היום, לא כולל קצב חילוף החומרים במנוחה, צריך לשלוח שאילתה active-energy-burned.
הקודם
אין לי מכשיר תואם
הבא
סימנים חיוניים