ממשקי ה-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 סשנים (ריצת בוקר וריצה אחר הצהריים), תוכלו לסווג את הצעדים לפי סשן כדי ללמוד את הצעדים הממוצעים או את המהירות הממוצעת של כל ריצה.
פעילות
אפשר להשתמש בסוגי הנתונים האלה כדי לקרוא נתונים נצברים של בריאות ורווחה.
סיכום פעילות
הזמן הכולל ומספר הפלחים עבור פעילות מסוימת לאורך תקופת זמן מסוימת.
כל נקודה על הגרף מייצגת סיכום של כל פלחי הפעילות של קבוצת נתונים מסוימת.
סוג הפעילות בפרק זמן מסוים.
המספר של פלחי פעילות ייחודיים במהלך מרווח הזמן של נקודת הנתונים הזו.
סיכום קצב חילוף החומרים הבסיסי (BMR)
כל נקודה על הגרף מייצגת את קצב חילוף החומרים הבסיסי הבסיסי, המקסימלי והמינימלי של המשתמש
לאורך טווח הזמן, בקלוריות ליום. האפשרות הזאת שימושית אם למשתמש
עלו או ירדו במשקל ולכן ה-BMR שלהם השתנה.
המהירות הממוצעת של המשתמש בפרק זמן מסוים, במטרים לשנייה.
מקסימום (float — מטרים לשנייה)
המהירות המקסימלית של המשתמש בפרק זמן מסוים, במטרים לשנייה.
min (float — מטרים לשנייה)
המהירות המינימלית של המשתמש בפרק זמן מסוים, במטרים לשנייה.
Android
שם
com.google.speed.summary
אובייקט של סוג הנתונים
AGGREGATE_SPEED_SUMMARY
שדות (פורמט, יחידות)
ממוצע (float — מטרים לשנייה)
המהירות הממוצעת של המשתמש בפרק זמן מסוים, במטרים לשנייה.
מקסימום (float — מטרים לשנייה)
המהירות המקסימלית של המשתמש בפרק זמן מסוים, במטרים לשנייה.
min (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
מ"ג/ד"ל
אם הערכים בכל אחד מהשדות זהים בכל המדידות
במהלך טווח הזמן תראו את ערך השדה בנתונים המוחזרים:
רמת הסוכר הממוצעת של המשתמש בדם במשך תקופה מסוימת.
מקסימום (float — mmol/L)
רמת הסוכר המקסימלית או ריכוז הסוכר המקסימלי של המשתמש לאורך תקופה מסוימת.
מינימום (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
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
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_BLOOD_PRESSURE_DIASTOLIC_MIN (float - mmHg)
לחץ הדם הדיאסטולי המינימלי של המשתמש במשך תקופה מסוימת.
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
סיכום טמפרטורת הגוף
כל נקודה על הגרף מייצגת את טמפרטורת הגוף הממוצעת, המינימלית והמקסימלית
את המשתמש בטווח זמן מסוים.
יוצג גם המיקום שבו בוצעה המדידה, אם
מיקום המדידה היה זהה לכל נקודות הנתונים בפרק הזמן הזה.
[null,null,["עדכון אחרון: 2024-08-22 (שעון UTC)."],[[["Google Fit uses aggregate data types to provide summaries of health and wellness metrics, like steps, calories, and heart rate, over specific time periods."],["Developers can retrieve aggregated data by specifying the data type, time range, and how the data should be grouped (e.g., by time period, activity type, or session)."],["Data is categorized into activity, body, and location, each with specific data types and fields providing aggregated values like totals, averages, minimums, and maximums."],["Aggregate data types are read-only, meaning you can only retrieve data, not write or modify it."],["Accessing aggregate data types requires appropriate OAuth permissions, and Google Fit offers both REST and Android APIs for retrieval."]]],[]]