ממשק API של פלטפורמת Health

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

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

Health Platform API מספק למשתמשים מנגנון אחסון ושיתוף שמאפשר להם לבחור לאילו אפליקציות תהיה גישה לנתונים האישיים שלהם בנושאי בריאות, כושר ואיכות חיים, ולהציג את הנתונים האלה. כך מפתחי האפליקציות יכולים להציג למשתמשים תמונה מלאה יותר של בריאותם, והמשתמשים יכולים לעקוב אחרי הנתונים שלהם בצורה יעילה יותר.

ערכת הפיתוח של Health Platform API מספקת למפתחי אפליקציות ל-Android את כל מה שנחוץ להם כדי לספק גישה לנתוני הבריאות והכושר של משתמשים במכשירי Samsung נבחרים, ומאפשרת לאפליקציות לבצע פעולות בכמות גדולה, כמו הוספה, מחיקה וקריאה של נתונים.

שנתחיל?

כשמשתמשים ב-Health Platform, חשוב לזכור את הדברים הבאים:

• אפליקציות לקוח צריכות לקבל מהמשתמש הרשאות מפורטות לגישה לקריאה או לכתיבה.
• המשתמש יכול לדחות הרשאות או לבטל אותן בכל שלב.
• Health Platform API תומך רק במכשירי Samsung נבחרים.
• HealthDataClient הוא הלקוח של Health Platform ונקודת הכניסה אליה.

בתמונה הבאה מוצגים שלבי השילוב הנדרשים שמפתחים צריכים לבצע:

קובצי גרסאות

הגרסה 1 של Health Platform כוללת את הרכיבים הבאים:

• Client SDK: צריך לכלול את ערכת ה-SDK הזו באפליקציה כדי להשתמש ב-Health Platform API. ה-SDK הוא מאגר Maven שאפשר לכלול אותו ישירות בקובצי ה-build של האפליקציה ב-Gradle.

התקנת Health Platform

כדי להתקין את Health Platform:

בקובץ build.gradle ברמה הבסיסית של האפליקציה, מוסיפים את המאגר, כפי שמתואר בדוגמה הבאה:

allprojects {
    . . .
    repositories {
        . . .
        google()
    }
}

מוסיפים יחסי תלות ל-Health Platform SDK בקובץ build.gradle של המודול, כפי שמתואר בדוגמה הבאה:

נתונים

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

ריכזנו כאן את האובייקטים המרכזיים בפלטפורמת Health וההבדלים ביניהם:

• RawData: רשומת מדידה ונתונים.
• DataType: ספציפי לסוגים נפוצים של נתוני בריאות וכושר, כמו קצב הלב, אחוז השומן בגוף או טמפרטורת הגוף, וכן לפורמטים שלהם, כמו שדות, קריאה בלבד או אופציונליים.
• SampleData: אובייקט RawData שהוא מדידה מיידית, כמו קצב הלב, לחץ הדם או מהירות הריצה.
• IntervalData: אובייקט RawData שהוא מדידה מצטברת שנלקחה לאורך תקופה מסוימת, כמו מספר הצעדים, המרחק שעברתם או הקלוריות שנשרפו.
• SeriesData: אובייקט RawData שמכיל רצף של מדידות לאורך תקופת זמן. SeriesData מתאים במיוחד לנתוני חיישנים בתדירות גבוהה, כמו דגימות רציפות של קצב הלב במהלך סשן פעילות.

כל אחת משלוש הכיתות RawData תואמת לקבוצת משנה ספציפית של DataType: SampleData,‏ IntervalData ו-SeriesData תואמות ל-SampleDataType,‏ IntervalDataType ו-SeriesDataType, בהתאמה.

כשכל אובייקט RawData מוכנס, פלטפורמת Health מקצה לו מזהה ייחודי (UID). אפשר להשתמש במזהה ה-UID הזה כדי להפנות לאובייקט RawData ספציפי בבקשות קריאה, עדכון או מחיקה.

סוגי הנתונים

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

כל סוג נתונים מוגדר לפי פורמט הנתונים שלו, שכולל את הפרטים הבאים:

• שדות: שדות ספציפיים או כלליים שמשויכים לסוג הנתונים. לדוגמה, לסוג הנתונים 'רמת החמצן בדם (SpO2)' יש שדות כמו 'שם', 'הערות' ו'אחוז'.
• סוג: long,‏ double,‏ string או enum.
• מאפיין: לקריאה בלבד, נדרש, אופציונלי או טווח אימות.

רשימה של סוגי נתונים

כדי להפיק את המקסימום מפלטפורמת Health, חשוב להבין את סוגי הנתונים הזמינים. פלטפורמת Health תומכת בסוגי הנתונים שמפורטים בטבלה הבאה. סוגי הנתונים מאורגנים לפי הפורמט שלהם: דגימה, מרווח זמן או סדרה.

SampleData סוגים:

IntervalData סוגים:

SeriesData סוגים:

פונקציות למפתחים

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

קריאת AggregatedData

הפלטפורמה מאפשרת ללקוחות להחיל פונקציית צבירה על הסוגים הבאים של AggregatedData:

• StatisticalData: הערכים הממוצעים, המינימליים או המקסימליים בקבוצה של SampleData או SeriesData, למשל קצב הלב המינימלי והמקסימלי במהלך סשן פעילות.
• CumulativeData: הסכום של ערכי IntervalData, למשל מספר הצעדים הכולל בטווח זמן יומי.
• CountData: ספירה פשוטה של מספר אובייקטי RawData הבסיסיים, כמו מספר סשנים של פעילות בשבוע נתון. אפשר לחשב נתוני ספירה עבור סוגים של נתוני דגימה, מרווח וסדרה.

קישור ל-Health Platform API

HealthDataClient היא נקודת הכניסה ל-Health Platform API.

בשלבים הבאים מוסבר איך להתחבר ל-Health Platform:

1. משתמשים ב-HealthDataService.getClient כדי ליצור מכונות HealthDataClient חדשות.
2. לאחר מכן, אפליקציית הלקוח צריכה לבקש מהמשתמש הרשאה באמצעות השיטה requestPermissions (Set).

HealthDataClient מנהל באופן אוטומטי את החיבור לשכבת האחסון הבסיסית, ומטפל בכל התקשורת בין תהליכים (IPC) ובסריאליזציה של בקשות יוצאות ותשובות נכנסות.