ממשקי ה-API של Google Fit, כולל Google Fit, לא יהיו זמינים יותר אחרי 30 ביוני 2025. החל מ-1 במאי 2024, מפתחים לא יוכלו להירשם לשימוש בממשקי ה-API האלה.
לגבי נתונים שאפשר לתעד באופן רציף (עם מספר נקודות על הגרף במהלך פרק זמן מסוים), פלטפורמת Google Fit יכולה לצבור את הנתונים האלה ולהחזיר את התוצאות המחושבות. זה יכול להיות מדידה ממוצעת או סיכום/סכום. על ידי קריאת הנתונים הנצברים אפשר לחסוך את הזמן שנדרש לחישובים האלה ולהציג למשתמשים באפליקציה סיכומים או ממוצעים שימושיים.
על מנת לקרוא נתונים נצברים, צריך לבחור סוג נתונים, טווח זמן ומאפיין ל 'קטגוריה' (או קיבוץ) של הנתונים. ניתן לחלק את הנתונים לקטגוריות בכמה דרכים שונות:
תקופת זמן
קטגוריה של נתונים נצברים לפי שעה או יום. לדוגמה, ניתן לראות את מספר הצעדים או מספר הקלוריות ששרפת ביום.
סוג הפעילות
קטגוריה של נתונים נצברים לפי סוג הפעילות. לדוגמה, לגבי נתוני שינה במהלך שבוע, תהיה קטגוריה לכל סוג של פעילות שינה (קל, עמוק ו-REM).
קטע פעילות
קטגוריה של נתונים נצברים לפי פלחי הפעילות בתקופה מסוימת. לדוגמה, אם משתמש יצא לריצה בין 9:00 ל-10:00 אבל רץ במשך 20 הדקות הראשונות, ישב במשך 10 דקות, הלך במשך 15 דקות ורץ במשך 15 דקות, הריצות האלה נחשבות ל-4 פלחי פעילות ויחזירו 4 קטגוריות.
סשן
להשתמש בגבולות הזמן של ביקורים כדי לצבור נתונים. לדוגמה, אם משתמש השתתף למשך 2 ריצות שנרשמו כ-2 סשנים (ריצת בוקר וריצה אחר הצהריים), אפשר לסווג את המשתמש לפי סשן כדי ללמוד את הצעדים הממוצעים או את המהירות הממוצעת של כל ריצה.
פעילות
כדאי להשתמש בסוגי הנתונים האלה כדי לקרוא נתונים נצברים של הבריאות ואיכות החיים.
סיכום פעילויות
הזמן הכולל ומספר הפלחים עבור פעילות מסוימת לאורך תקופת זמן.
כל נקודה על הגרף מייצגת סיכום של כל פלחי הפעילות לסוג פעילות מסוים לאורך פרק זמן.
סוג הפעילות שהמשתמש ביצע. כאן אפשר לראות את הרשימה של סוגי הפעילות.
duration (int - אלפיות שנייה)
הזמן הכולל שהוקדש לפעילות בכל הקטעים בטווח הזמן.
מספר הפלחים (int—ספירה)
מספר פלחי הפעילות הנפרדים במהלך מרווח הזמן של נקודת הנתונים הזו.
Android
שם
com.google.activity.summary
אובייקט סוג נתונים
AGGREGATE_ACTIVITY_SUMMARY
שדות (פורמט – יחידות)
FIELD_ACTIVITY (int — טיפוסים בני מנייה (enum))
סוג הפעילות שהמשתמש ביצע. כאן אפשר לראות את הרשימה של סוגי הפעילות.
FIELD_DURATION (int - אלפיות שנייה)
הזמן הכולל שהוקדש לפעילות בכל הקטעים בטווח הזמן.
FIELD_NUM_SEGMENTS (int – ספירה)
מספר פלחי הפעילות הנפרדים במהלך מרווח הזמן של נקודת הנתונים הזו.
סיכום קצב חילוף החומרים הבסיסי (BMR)
כל נקודה על הגרף מייצגת את קצב חילוף החומרים הבסיסי, המקסימלי והמינימלי של המשתמש בטווח הזמן, בקלוריות ליום. זו שיטה שימושית אם המשתמש צבר או איבד משקל, ולכן ה-BMR שלו השתנה.
ההספק הממוצע של המשתמש שנוצר במהלך תקופת הזמן, בוואט.
max (float – ואט)
ההספק המקסימלי של המשתמש שנוצר במהלך תקופת הזמן, בוואט.
min (float – ואט)
ההספק המינימלי של המשתמש שנוצר במהלך תקופת הזמן, בוואטים.
Android
שם
com.google.power.summary
אובייקט סוג נתונים
AGGREGATE_POWER_SUMMARY
שדות (פורמט – יחידות)
FIELD_AVERAGE (float - ואט)
ההספק הממוצע של המשתמש שנוצר במהלך תקופת הזמן, בוואט.
FIELD_MAX (float – ואט)
ההספק המקסימלי של המשתמש שנוצר במהלך תקופת הזמן, בוואט.
FIELD_MIN (float – ואט)
ההספק המינימלי של המשתמש שנוצר במהלך תקופת הזמן, בוואטים.
סיכום דלתא של ספירת צעדים
כל נקודה על הגרף מייצגת את מספר השלבים הכולל במהלך תקופת הזמן.
סוג הנתונים הזה והשדות שלו זהים לסוג הנתונים המיידי.
גוף
כדאי להשתמש בסוגי הנתונים האלה כדי לקרוא נתונים נצברים של מדידה גופנית.
סיכום אחוזי השומן בגוף
כל נקודה על הגרף מייצגת את הממוצע, המקסימום והמינימלי של אחוז שומן בגוף בתקופת זמן מסוימת.
REST
שם
com.google.body.fat.percentage.summary
היקפי ההרשאות של OAuth
https://www.googleapis.com/auth/fitness.body.read
שדות (פורמט – יחידות)
ממוצע (float – אחוזים)
האחוז הממוצע של מסת הגוף הכוללת של המשתמש, כלומר שומן בגוף, בתקופה מסוימת.
max (float—אחוז)
האחוז המקסימלי של מסת הגוף הכוללת של המשתמש, כלומר שומן בגוף, בתקופה מסוימת.
min (float — אחוזים)
האחוז המינימלי של מסת הגוף הכוללת של המשתמש, שמייצג את אחוז השומן בגוף, בתקופה מסוימת.
Android
שם
com.google.body.fat.percentage.summary
אובייקט סוג נתונים
AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
שדות (פורמט – יחידות)
FIELD_AVERAGE (float – אחוזים)
האחוז הממוצע של מסת הגוף הכוללת של המשתמש, כלומר שומן בגוף, בתקופה מסוימת.
FIELD_MAX (float — אחוזים)
האחוז המקסימלי של מסת הגוף הכוללת של המשתמש, כלומר שומן בגוף, בתקופה מסוימת.
FIELD_MIN (float – אחוזים)
האחוז המינימלי של מסת הגוף הכוללת של המשתמש, שמייצג את אחוז השומן בגוף, בתקופה מסוימת.
סיכום הדופק
כל נקודה על הגרף מייצגת את הדופק הממוצע, המקסימלי והמינימלי של המשתמש בפרק הזמן, בפעימות לדקה.
REST
שם
com.google.heart_rate.summary
היקפי ההרשאות של OAuth
https://www.googleapis.com/auth/fitness.body.read
שדות (פורמט – יחידות)
ממוצע (float—פעימות לדקה)
הדופק הממוצע של המשתמש, בפעימות לדקה, בפרק זמן מסוים.
מקסימום (float—פעימות לדקה)
הדופק המקסימלי של המשתמש, בפעימות לדקה, בפרק זמן מסוים.
דקות (float—פעימות לדקה)
הדופק המינימלי של המשתמש, בפעימות בדקה, בפרק זמן מסוים.
Android
שם
com.google.heart_rate.summary
אובייקט סוג נתונים
AGGREGATE_HEART_RATE_SUMMARY
שדות (פורמט – יחידות)
FIELD_AVERAGE (float - פעימות לדקה)
הדופק הממוצע של המשתמש, בפעימות לדקה, בפרק זמן מסוים.
FIELD_MAX (float - פעימות לדקה)
הדופק המקסימלי של המשתמש, בפעימות לדקה, בפרק זמן מסוים.
FIELD_MIN (float - פעימות בדקה)
הדופק המינימלי של המשתמש, בפעימות בדקה, בפרק זמן מסוים.
סיכום גובה
כל נקודת נתונים מייצגת את הגובה הממוצע, המקסימלי והמינימלי של המשתמש בתקופת זמן מסוימת (במטרים).
REST
שם
com.google.height.summary
היקפי ההרשאות של OAuth
https://www.googleapis.com/auth/fitness.body.read
שדות (פורמט – יחידות)
ממוצע (float — מטרים)
הגובה הממוצע של המשתמש בתקופת זמן, במטרים.
מקסימום (float — מטרים)
הגובה המקסימלי של המשתמש בפרק זמן מסוים, במטרים.
דקות (float – מטרים)
הגובה המינימלי של המשתמש בתקופת זמן, במטרים.
Android
שם
com.google.height.summary
אובייקט סוג נתונים
AGGREGATE_HEIGHT_SUMMARY
שדות (פורמט – יחידות)
FIELD_AVERAGE (float – מטרים)
הגובה הממוצע של המשתמש בתקופת זמן, במטרים.
FIELD_MAX (float — מטרים)
הגובה המקסימלי של המשתמש בפרק זמן מסוים, במטרים.
FIELD_MIN (float — מטרים)
הגובה המינימלי של המשתמש בתקופת זמן, במטרים.
סיכום המשקל
כל נקודה על הגרף מייצגת את המשקל הממוצע, המקסימלי והמינימלי של המשתמש בתקופת זמן מסוימת, בקילוגרמים.
REST
שם
com.google.weight.summary
היקפי ההרשאות של OAuth
https://www.googleapis.com/auth/fitness.body.read
שדות (פורמט – יחידות)
ממוצע (float – ק"ג)
משקל הגוף הממוצע של המשתמש בתקופת זמן, בקילוגרמים.
מקסימום (float—ק"ג)
המשקל המקסימלי של המשתמש בפרק זמן מסוים, בקילוגרמים.
מינימום (float – ק"ג)
משקל הגוף המינימלי של המשתמש בפרק זמן מסוים, בקילוגרמים.
Android
שם
com.google.weight.summary
אובייקט סוג נתונים
AGGREGATE_WEIGHT_SUMMARY
שדות (פורמט – יחידות)
FIELD_AVERAGE (float - ק"ג)
משקל הגוף הממוצע של המשתמש בתקופת זמן, בקילוגרמים.
FIELD_MAX (float - ק"ג)
המשקל המקסימלי של המשתמש בפרק זמן מסוים, בקילוגרמים.
FIELD_MIN (float - ק"ג)
משקל הגוף המינימלי של המשתמש בפרק זמן מסוים, בקילוגרמים.
מיקום
אפשר להשתמש בסוגי הנתונים האלה כדי לקרוא נתוני מיקום נצברים.
דלתא של מרחק
כל נקודה על הגרף מייצגת את המרחק הכולל של המשתמש במשך תקופת זמן, במטרים. סוג הנתונים הזה והשדות שלו זהים לסוג הנתונים שמתבצע באופן מיידי.
תיבה תוחמת את המיקום
כל נקודה על הגרף מייצגת את התיבה התוחמת שמחושבת על פני נקודות המיקום של המשתמש לאורך תקופה. לכל תיבה תוחמת יש ארבע שדות שמייצגים את ארבע הפינות של התיבה התוחמת.
המהירות הממוצעת של המשתמש בתקופת זמן, במטרים לשנייה.
מקסימום (float – מטרים לשנייה)
המהירות המקסימלית של המשתמש בפרק זמן מסוים, במטרים לשנייה.
דקות (float – מטר לשנייה)
המהירות המינימלית של המשתמש בפרק זמן מסוים, במטרים לשנייה.
Android
שם
com.google.speed.summary
אובייקט סוג נתונים
AGGREGATE_SPEED_SUMMARY
שדות (פורמט – יחידות)
ממוצע (float – מטר לשנייה)
המהירות הממוצעת של המשתמש בתקופת זמן, במטרים לשנייה.
מקסימום (float – מטרים לשנייה)
המהירות המקסימלית של המשתמש בפרק זמן מסוים, במטרים לשנייה.
דקות (float – מטר לשנייה)
המהירות המינימלית של המשתמש בפרק זמן מסוים, במטרים לשנייה.
תזונה
כדאי להשתמש בסוגי הנתונים האלה כדי לקרוא נתונים תזונתיים מצטברים.
סיכום השתייה
כל נקודה על הגרף מייצגת את הנפח הכולל של מים שמשתמש צרך במהלך תקופה, בליטרים. סוג הנתונים הזה והשדות שלו זהים לסוג הנתונים שמתבצע באופן מיידי.
סיכום תזונה
כל נקודה על הגרף מייצגת את הסכום של כל הערכים התזונתיים לאורך תקופה מסוימת.
בשדה החומרים המזינים, כל ערך מייצג את הסכום של החומר התזונתי בכל הערכים של התקופה.
אם החומר התזונתי לא נכלל באף אחת מהרשומות, הוא לא יופיע גם במפה המסכמת. אם כל הרשומות בתקופת הזמן מתייחסות לאותה ארוחה, יוגדר גם סוג הארוחה.
"key": "calories" // Calories in kcal
"key": "fat.total" // Total fat in grams
"key": "fat.saturated" // Saturated fat in grams
"key": "fat.unsaturated" // Unsaturated fat in grams
"key": "fat.polyunsaturated" // Polyunsaturated fat in grams
"key": "fat.monounsaturated" // Monounsaturated fat in grams
"key": "fat.trans" // Trans fat in grams
"key": "cholesterol" // Cholesterol in milligrams
"key": "sodium" // Sodium in milligrams
"key": "potassium" // Potassium in milligrams
"key": "carbs.total" // Total carbohydrates in grams
"key": "dietary_fiber" // Dietary fiber in grams
"key": "sugar" // Amount of sugar in grams
"key": "protein" // Protein amount in grams
Android
שם
com.google.nutrition.summary
אובייקט סוג נתונים
AGGREGATE_NUTRITION_SUMMARY
שדות (פורמט – יחידות)
FIELD_MEAL_TYPE (int - טיפוסים בני מנייה (enum))
סוג הארוחה שהמשתמש אכל (במקרה כזה, אם כל הערכים של אותה ארוחה שייכים לאותה ארוחה).
NUTRIENT_CALORIES // Calories in kcal
NUTRIENT_TOTAL_FAT // Total fat in grams
NUTRIENT_SATURATED_FAT // Saturated fat in grams
NUTRIENT_UNSATURATED_FAT // Unsaturated fat in grams
NUTRIENT_POLYUNSATURATED_FAT // Polyunsaturated fat in grams
NUTRIENT_MONOUNSATURATED_FAT // Monounsaturated fat in grams
NUTRIENT_TRANS_FAT // Trans fat in grams
NUTRIENT_CHOLESTEROL // Cholesterol in milligrams
NUTRIENT_SODIUM // Sodium in milligrams
NUTRIENT_POTASSIUM // Potassium in milligrams
NUTRIENT_TOTAL_CARBS // Total carbohydrates in grams
NUTRIENT_DIETARY_FIBER // Dietary fiber in grams
NUTRIENT_SUGAR // Amount of sugar in grams
NUTRIENT_PROTEIN // Protein amount in grams
בריאות
כדאי להשתמש בסוגי הנתונים האלה כדי לקרוא נתונים רפואיים ובריאותיים נצברים.
סיכום רמת הסוכר בדם
כל נקודה על הגרף מייצגת את הרמה הממוצעת, המינימלית והמקסימלית של רמת הסוכר בדם בטווח הזמן, שנמדדת ב-mmol/L, כאשר 1 mmol/L הוא 18 מ"ג/dL.
אם הערכים בכל אחד מהשדות האלה זהים בכל המדידות שבוצעו במהלך טווח הזמן, ערך השדה יוצג בנתונים המוחזרים:
הרמה הממוצעת של הסוכר בדם או הריכוז הממוצע של המשתמש במהלך תקופת זמן מסוימת.
max (float—mmol/L)
הרמה המקסימלית של הסוכר בדם או הריכוז המקסימלי של המשתמש במהלך תקופה מסוימת.
min (float – mmol/L)
הרמה המינימלית של הסוכר בדם או הריכוז המינימלי של המשתמש במהלך תקופה מסוימת.
יחס זמן לארוחה (int—enum) (שדה אופציונלי)
מתי המדידה נערכה בהשוואה לזמן שבו המשתמש אכל.
ערכים קבילים
"intVal": 1 // Reading wasn't taken before or after a meal
"intVal": 2 // Reading was taken during a fasting period
"intVal": 3 // Reading was taken before a meal
"intVal": 4 // Reading was taken after a meal
יחס זמן לשינה (int – טיפוסים בני מנייה (enum)) (שדה אופציונלי)
מתי המדידה בוצעה בהשוואה לזמן השינה של המשתמש.
ערכים קבילים
"intVal": 1 // User was fully awake
"intVal": 2 // Before the user fell asleep
"intVal": 3 // After the user woke up
"intVal": 4 // While the user was still sleeping
FIELD_TEMPORAL_RELATION_TO_MEAL_GENERAL // Reading wasn't taken before or after a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_FASTING // Reading was taken during a fasting period
FIELD_TEMPORAL_RELATION_TO_MEAL_BEFORE_MEAL // Reading was taken before a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_AFTER_MEAL // Reading was taken after a meal
FIELD_MEAL_TYPE (int - טיפוסים בני מנייה (enum)) (שדה אופציונלי)
TEMPORAL_RELATION_TO_SLEEP_FULLY_AWAKE // User was fully awake.
TEMPORAL_RELATION_TO_SLEEP_BEFORE_SLEEP // Before the user fell asleep.
TEMPORAL_RELATION_TO_SLEEP_ON_WAKING // After the user woke up.
TEMPORAL_RELATION_TO_SLEEP_DURING_SLEEP // While the user was still sleeping.
לחץ הדם הדיאסטולי המינימלי של המשתמש לאורך תקופה מסוימת.
FIELD_BODY_POSITION (int—enum) (שדה אופציונלי)
המיקום של המשתמש בזמן המדידה.
ערכים קבילים
BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_WRIST // Left wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_WRIST // Right wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_UPPER_ARM // Left upper arm
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_UPPER_ARM // Right upper arm
סיכום טמפרטורת הגוף
כל נקודה על הגרף מייצגת את טמפרטורת הגוף הממוצעת, המינימלית והמקסימלית של המשתמש בטווח זמן.
המאפיין הזה כולל גם את המיקום שבו בוצעה המדידה בגוף, אם מיקום המדידה היה זהה בכל נקודות הגרף באותו זמן.