סוגי נתונים ב-Google Health API

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

חשוב: הפורמט של מזהי סוגי הנתונים שונה כשסוג הנתונים כולל יותר ממילה אחת. בנקודת קצה, שם סוג הנתונים צריך להיות בפורמט שכולל מקפים במקום רווחים, כמו body-fat. לעומת זאת, בפרמטר של מסנן, שם סוג הנתונים צריך להיות בפורמט snake case, למשל body_fat.

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

סוג הנתונים   dataType הפרמטר   filter	סוג הרשומה	פעולות זמינות	היקף	תמיכה ב-Webhook	תמיכה באפסים אמיתיים
האנרגיה הפעילה שנשרפה   active-energy-burned   active_energy_burned	מרווח	list, reconcile, rollup, dailyRollup	activity_and_fitness
Active Minutes   active-minutes   active_minutes	מרווח	list, reconcile, rollup, dailyRollup	activity_and_fitness
דקות טווח פעילות   active-zone-minutes   active_zone_minutes	מרווח	list, reconcile, rollup, dailyRollup	activity_and_fitness
רמת הפעילות   activity-level   activity_level	מרווח	רשימה, התאמה	activity_and_fitness
גובה   altitude   altitude	מרווח	list, reconcile, rollup, dailyRollup	activity_and_fitness
סוכר בדם   blood-glucose   blood_glucose	דוגמה	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Body Fat   body-fat   body_fat	דוגמה	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements
קלוריות שנשרפו בטווח הדופק   calories-in-heart-rate-zone   calories_in_heart_rate_zone	מרווח	rollup, dailyRollup	activity_and_fitness
Core Body Temperature   core-body-temperature   core_body_temperature	דוגמה	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Daily Heart Rate Variability   daily-heart-rate-variability   daily_heart_rate_variability	יומי	רשימה, התאמה	health_metrics_and_measurements
Daily Heart Rate Zones   daily-heart-rate-zones   daily_heart_rate_zones	יומי	רשימה, התאמה	health_metrics_and_measurements
רמת החמצן בדם מדי יום   daily-oxygen-saturation   daily_oxygen_saturation	יומי	רשימה, התאמה	health_metrics_and_measurements
Daily Respiratory Rate   daily-respiratory-rate   daily_respiratory_rate	יומי	רשימה, התאמה	health_metrics_and_measurements
Daily Resting Heart Rate   daily-resting-heart-rate   daily_resting_heart_rate	יומי	רשימה, התאמה	health_metrics_and_measurements
Daily Sleep Temperature Derivations   daily-sleep-temperature-derivations   daily_sleep_temperature_derivations	יומי	רשימה, התאמה	health_metrics_and_measurements
Daily VO2 Max   daily-vo2-max   daily_vo2_max	יומי	רשימה, התאמה	activity_and_fitness
מרחק   distance   distance	מרווח	list, reconcile, rollup, dailyRollup	activity_and_fitness
Electrocardiogram (ECG)   electrocardiogram   electrocardiogram	סשן	list	ecg
תרגיל   exercise   exercise	סשן	list, get, reconcile, create, update, batchDelete	activity_and_fitness
קומות   floors   floors	מרווח	התאמה, סיכום, סיכום יומי	activity_and_fitness
אוכל   food   food	אוכל	list, get	תזונה
יחידת מידה של מזון   food-measurement-unit   food_measurement_unit	אוכל	list, get	תזונה
דופק   heart-rate   heart_rate	דוגמה	list, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Heart Rate Variability   heart-rate-variability   heart_rate_variability	דוגמה	רשימה, התאמה	health_metrics_and_measurements
גובה   height   height	דוגמה	list, get, reconcile, create, update, batchDelete	health_metrics_and_measurements
יומן מאזן נוזלים   hydration-log   hydration_log	סשן	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	תזונה
התראה על הפרעת קצב (IRN)   irregular-rhythm-notification   irregular_rhythm_notification	סשן	list	irn
יומן תזונה   nutrition-log   nutrition_log	דוגמה	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	תזונה
ריווי חמצן בדם   oxygen-saturation   oxygen_saturation	דוגמה	רשימה, התאמה	health_metrics_and_measurements
סיכום קצב הנשימה בשינה   respiratory-rate-sleep-summary   respiratory_rate_sleep_summary	דוגמה	רשימה, התאמה	health_metrics_and_measurements
Run VO2 Max   run-vo2-max   run_vo2_max	דוגמה	list, reconcile, rollup, dailyRollup	activity_and_fitness
תקופה של חוסר פעילות   sedentary-period   sedentary_period	מרווח	list, reconcile, rollup, dailyRollup	activity_and_fitness
שינה   sleep   sleep	סשן	list, get, reconcile, create, update, batchDelete	שינה
שלבים   steps   steps	מרווח	list, reconcile, rollup, dailyRollup	activity_and_fitness
נתונים של אורך הבריכה   swim-lengths-data   swim_lengths_data	מרווח	list, reconcile, rollup, dailyRollup	activity_and_fitness
Time in Heart Rate Zone   time-in-heart-rate-zone   time_in_heart_rate_zone	מרווח	list, reconcile, rollup, dailyRollup	activity_and_fitness
סה"כ קלוריות   total-calories   total_calories	מרווח	rollup, dailyRollup	activity_and_fitness
VO2 Max   vo2-max   vo2_max	דוגמה	רשימה, התאמה	activity_and_fitness
משקל   weight   weight	דוגמה	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements

זמינות הנתונים

העדכונים של נתוני המשתמש זמינים רק אחרי שהמשתמש מסנכרן את מכשיר מעקב הפעילות שלו או מזין נתונים חדשים באופן ידני באפליקציית Fitbit לנייד או לאינטרנט. מכשיר Fitbit ואפליקציית Fitbit לנייד יכולים להסתנכרן אוטומטית כל 15 דקות כשאפליקציית Fitbit פתוחה במכשיר הנייד ושני המכשירים מחוברים באופן פעיל לנתונים ונמצאים בטווח ה-Bluetooth. אם המשתמש עוקב אחרי הפעילות באמצעות MobileTrack, הנתונים מסתנכרנים כל שעה כל עוד האפליקציה פתוחה.

גישה של צד שלישי

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

המכשיר מסנכרן את הנתונים באופן אוטומטי במהלך היום, בכל פעם שאפליקציית Fitbit פתוחה, או כל 15 דקות אם ה-Bluetooth פעיל והאפליקציה פועלת ברקע. אחרי שתהליך הסנכרון יסתיים, הנתונים יהיו זמינים לשירותי צד שלישי דרך Google Health API.

סטנדרטים של מרחק

מרחקי תרגילים, כמו elevationGainMillimeters, נמדדים במילימטרים כיחידת המידה הסטנדרטית מהסיבות הבאות:

1. שמירה על דיוק הנתונים: הסיבה הכי חשובה לשימוש במילימטרים היא לוודא שלא נאבד דיוק בנתונים שאנחנו קוראים ומספקים. שימוש ביחידה מדויקת כמו מילימטרים מאפשר לנו להציג מדידות ברמת דיוק גבוהה.
2. תקינה: מילימטרים הם יחידת המידה הסטנדרטית שמוגדרת בשירותים שלנו. העקביות הזו עוזרת להבטיח חוויה אחידה למפתחים שמשתמשים בחלקים שונים של ה-API.
3. תמיכה רחבה במערכות מדידה: שימוש ביחידת בסיס כמו מילימטרים מאפשר למפתחים להמיר בקלות לכל יחידה אחרת, בלי קשר למערכת המדידה שבה הם משתמשים (מטרית, אימפריאלית או אחרת).

משך יום משתנה

ב-Health API, הטיפול בזמן מתבצע לפי הזמן של המשתמש כדי להתחשב באורכי ימים משתנים שנגרמים בגלל שעון קיץ או נסיעות. כל נקודת נתונים מאוחסנת עם חותמת זמן פיזית ב-UTC ועם ההפרש מ-UTC שהיה פעיל בזמן האירוע. כך המערכת יכולה:

• מיפוי האירוע לנקודת זמן פיזית מדויקת.
• השעה מתוקנת לפי ההקשר המקומי של המשתמש לצורך צבירה.

שעון קיץ

כששעון הקיץ מתחיל, יש "חזרה לאחור" שגורמת לכך שהיום האזרחי נמשך 25 שעות, והסיכום של התאריך הזה יכיל נתונים של 25 שעות. הזזת השעון קדימה גורמת ליום אזרחי של 23 שעות, שבו השעה מוחזרת לשעון רגיל.

נסיעות

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

משתמשים בנקודת הקצה dailyRollUp כדי לגשר על הפערים בין אזורי הזמן. המערכת משייכת את הנתונים באופן אוטומטי ליום הקלנדרי שבו הם נרשמו, לפי הזמן המקומי של המשתמש. כך היא למעשה 'תופרת' את היום למרות שינויים באזור הזמן.