כדי להבטיח שהנתונים יהיו מדויקים והסיכומים יהיו עקביים, Google Health API משפר את הדיווח על פעילות המשתמש. באמצעות true zeros ו-on-wrist filtering, ה-API מאפשר להבחין בצורה מדויקת בין תקופות שבהן המשתמש היה נייח לבין תקופות שבהן הוא לא ענד את המכשיר.
True Zeros
אפס אמיתי הוא נקודה על הגרף שמציינת שמשתמש ענד את המכשיר שלו ועקב אחרי נתונים באופן פעיל, אבל נרשם ערך אפס למדד ספציפי. לדוגמה, יכול להיות שמשתמש ירשום 0 צעדים או 0 מרחק במהלך מרווח של דקה אחת בזמן שהוא עונד את המכשיר שלו.
בעבר, נתונים חסרים היו דו-משמעיים. יכול להיות שהמשתמש היה בישיבה או שהמכשיר לא היה על היד. כדי לפתור את הבעיה הזו, ה-API מאחסן ומחזיר ערך של 0 באופן מפורש כשהמכשיר מורכב על הגוף אבל לא פעיל. כך תוכלו להבחין בבירור בין תקופות שבהן השעון היה על היד ולא זז לבין נתונים חסרים.
סינון בשעון
סינון על היד הוא תהליך שבו בודקים אם המשתמש עונד את המכשיר. כך ה-API יכול לסנן נתונים מיותרים, כמו צעדים 'וירטואליים' שתועדו בגלל רעידות של הרכב בזמן שהמכשיר נמצא בתיק.
סוגי נתונים נתמכים
סוגי הנתונים הבאים תומכים בהתנהגות של אפס אמיתי ובסינון על היד:
- גובה
- מרחק
- קומות
- שלבים
- סך הקלוריות
ההשפעה על האפליקציה
ההטמעה של אפסים אמיתיים משפרת את הדיוק של פרשנות פערים בנתונים וחישובים של מדדים, כמו ממוצעים יומיים.
התנהגות של רשימות וסיכומים
כברירת מחדל, Google Health API מחזיר רק נתונים שנמדדו על היד עבור סוגי הנתונים הבאים:
- פעולות ברשימה: מחזירה נקודות נתונים רק לתקופות שבהן המכשיר היה על היד. פערים ברשימה מציינים שהמכשיר לא היה על היד או שלא בוצע בו סנכרון.
- פעולות סיכום: אפס בתגובה מציין אפס אמיתי (המשתמש ענד את המכשיר אבל לא זז). אם מכשיר מעקב לא היה בשימוש במהלך מרווח זמן מסוים, ה-API לא מחזיר נתונים לגבי חלון הצבירה הזה.
השוואה ל-Fitbit Web API
Fitbit Web API החזיר לעיתים קרובות נתונים, כולל אפסים, גם כשמכשיר המעקב לא היה על המשתמש. ממשק Google Health API מספק ייצוג מדויק יותר של התנועה.
| תכונה | Fitbit Web API | Google Health API |
|---|---|---|
| חוסר פעילות לא ברור | נתונים חסרים יכולים להעיד על חוסר פעילות או על כך שהשעון לא היה על היד. | אפסים אמיתיים מציינים באופן מפורש חוסר פעילות בזמן שהמכשיר ענוד. |
| פערים בנתונים | יכול להיות שברירת המחדל של פערים בנתונים תהיה היסטים של UTC. | אחסון מפורש פותר בעיות שקשורות לאזור זמן ולזמן אזרחי. |
| סינון | סינון מוגבל על פרק כף היד. | סינון קפדני של נתונים מהיד מבטיח דיוק פיזיולוגי. |