פיתוח חוויות של צעדים באמצעות Google Health API

‫Google Health API עוקב אחרי נתוני הפעילות והצעדים של המשתמשים באמצעות סוג הנתונים steps interval. ספירת הצעדים היא מדד בסיסי לפעילות גופנית יומית, שעוזר למפתחים לעקוב אחרי ההתקדמות בכושר, לחשב את הוצאת האנרגיה וליצור סיכומי פעילות יומיים שגלויים למשתמשים.

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

סוגי נתונים נתמכים

ה-API תומך בסוג הנתונים הבא למעקב אחרי ספירת הצעדים:

טבלה: סוגי נתונים של צעדים ב-Google Health API
סוג הנתונים פעולות
אפשריות
היקף
שלבים
dataType: steps
filter parameter: steps
סוג רשומה: אינטרוול
רזולוציית אחסון: דקה אחת

מכשירים תואמים

list, reconcile, rollup, dailyRollup .activity_and_fitness.readonly
.activity_and_fitness.writeonly

הנחיות

כשמשלבים מעקב אחר צעדים באפליקציה, צריך לפעול לפי ההנחיות הבאות לעיצוב ולהטמעה.

חישוב מהירות וקצב

‫Google Health API משתמש בנוסחאות סטנדרטיות כדי לחשב את המהירות והקצב:

  • מהירות = distance / time(hour)
  • קצב = time(seconds) / distance

הכותרת Accept-Language שצוינה בבקשה קובעת את יחידת המרחק.

סקירה יומית

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

ממשקי משתמש לציור (התאמה)

כשיוצרים רכיבים בממשק המשתמש כדי להציג נתוני צעדים, משתמשים בנקודת הקצה (endpoint) reconcile. אם כמה מקורות נתונים (כמו שעון חכם וטלפון נייד) תיעדו צעדים באותו זמן, נקודת הקצה reconcile פותרת את ההתנגשויות וממזגת את הנתונים כדי להחזיר מקור נתונים אחד ומותאם.

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

מעקב והיסטוגרמות במהלך היום

כדי להציג פעילות מפורטת של המשתמשים לאורך היום (כמו תרשימים וגרפים):

  • היסטוגרמות של צעדים לפי שעה או דקה: שולחים שאילתה לנקודת הקצה (endpoint) rollUp, ומציינים את משך הזמן (למשל 60s לדקה אחת או 3600s לשעה אחת) באמצעות הפרמטר windowSize. נתוני הצעדים נרשמים במרווחים של דקה אחת (60s), לכן צריך להגדיר את windowSize לערך של 60s לפחות. בבקשות עם חלונות זמן קצרים מדקה (כמו 10s או 30s), הסכומים של כל דקה לא מחולקים, והספירה של הדקה המלאה נכנסת לקטגוריית המשנה התואמת הראשונה. לפרטים נוספים, קראו את המאמר חלון סיכום ורזולוציית אחסון.
  • כל רשומות הצעדים: משתמשים בנקודת הקצה list כדי לאחזר את רשומות הצעדים הגולמיות והמפורטות ביותר.

נקודות הקצה rollUp,‏ dailyRollUp ו-reconcile מקבלות את הפרמטר dataSourceFamily, שמאפשר לסנן נתונים מקבוצות מקור ספציפיות. לפרטים נוספים ולדוגמאות לשימוש, ראו את הקטע סינון לפי משפחת מקורות נתונים במדריך לסינון נתונים.

סנכרון באמצעות תגובות לפעולה מאתר אחר (webhooks)

נרשמים לאוסף של סוג הנתונים steps כדי לקבל התראה כשנתוני צעדים חדשים מיובאים או מסונכרנים. במקום לדגום נקודות קצה (endpoints) של REST, אפשר לעדכן באופן דינמי את מרכזי הבקרה בצד הלקוח בתגובה להתראות האלה של ה-webhook. במאמר מינויים ל-Webhook מוסבר איך מגדירים מינויים.