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

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

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

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

סוג הנתונים   dataType הפרמטר   filter	סוג הרשומה	פעולות זמינות	היקף	תמיכה ב-Webhook
Active Energy Burned   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	מרווח	איחוד לתצוגה אחת, איחוד יומי לתצוגה אחת	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   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   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	מרווח	איחוד לתצוגה אחת, איחוד יומי לתצוגה אחת	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 ואפליקציית Fitbit לנייד יכולים להסתנכרן אוטומטית כל 15 דקות כשאפליקציית Fitbit פתוחה במכשיר הנייד ושני המכשירים מחוברים באופן פעיל לנתונים ונמצאים בטווח ה-Bluetooth. אם המשתמש עוקב אחרי הפעילות באמצעות MobileTrack, הנתונים של MobileTrack מסתנכרנים כל שעה כל עוד האפליקציה פתוחה.

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

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

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

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

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

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