מדריך להעברת נתונים (מיגרציה)

ל-Google יש מגוון רחב של מוצרים ושירותים בתחום הבריאות, כולל Health Connect. ממשקי Google Fit API הוצאו משימוש, והתמיכה בהם תסתיים ב-2026. בהנחיות הבאות מוסבר לאיזה API או פלטפורמה צריך לעבור מכל Google Fit Android API.

מעבר מ-Fit Android API ל-Health Connect API

יש 3 שלבים עיקריים שצריך לבצע כדי לעבור ל-Health Connect API.

שלב 1: שילוב

השלב הראשון בשילוב הוא להוסיף את Health Connect לאפליקציה. התהליך כולל את הפעולות הבאות:

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

שלב 2: העברה

מומלץ להשאיר את השילובים של Google Fit Android API ו-Health Connect API פעילים בזמן שהמשתמשים עוברים מפלטפורמה אחת לאחרת. הוצאנו משימוש את Google Fit Android API, אבל אנחנו מתכננים להשבית את ה-API לא לפני 2026. המטרה היא לתת למשתמשים מספיק זמן לעבור ל-Health Connect ולהמשיך את השירות.

שלב 3: ניקוי

כדי להסיר את Google Fit SDK:

  1. מסירים את הקוד שמשויך ל-Google Fit Android API.
  2. מסירים את היחסי התלות של שירותי Google Play.

Sensor API

באמצעות Sensor API אפשר לקרוא נתוני חיישנים גולמיים באפליקציה בזמן אמת. באמצעות Sensor API אפשר:

  • רשימה של מקורות הנתונים שזמינים במכשיר ובמכשירים נלווים.
  • רישום מאזינים לקבלת נתוני חיישנים גולמיים.
  • מבטלת את הרישום של מאזינים כדי שהם לא יקבלו יותר נתוני חיישנים גולמיים.

מעבר מה-Sensor API לממשקי ה-API או לפלטפורמות הבאים:

טלפון Wear

שימוש ב-SensorManager וב-FusedLocationProvider

שימוש בשירותי בריאות

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    לחלופין, אפשר להשתמש ב-SensorManager,‏ FusedLocationProvider

Session API

סשנים מייצגים מרווח זמן שבו משתמשים מבצעים פעילות גופנית.

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

מעבר מה-Session API לממשקי ה-API או לפלטפורמות הבאים:

טלפון Wear

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

קריאה/כתיבה: משתמשים ב-Health Connect.

הפעלה/השבתה: שימוש ב-Health Services‏ (ExerciseClient)

קריאה/כתיבה: שימוש ב-Health Connect דרך האפליקציה לנייד.

בתהליכי עבודה ספציפיים, מומלץ:

  • הוספת סשן: המפתחים צריכים להשתמש ב-Health Connect דרך האפליקציה לנייד ולהוסיף רשומה של סשן אימון או רשומה של סשן שינה בהתאם.

Recording API

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

מעבר מה-Recording API לממשקי ה-API או לפלטפורמות הבאים:

טלפון Wear

כדי לעבור מ-Recording API:

  1. הטמעת איסוף נתונים באמצעות Recording API בנייד.
  2. כתיבת הנתונים שצולמו ב-Health Connect או במסד הנתונים של האפליקציה.

שימוש בשירותי בריאות

  • PassiveMonitoringClient
  • ExerciseClient

מידע נוסף על ההבדלים בין PassiveMonitoringClient לבין ExerciseClient זמין במסמכי העזרה של Health Services.

History API

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

מעבר מה-History API לממשקי ה-API או לפלטפורמות הבאים:

טלפון Wear

שימוש ב-Health Connect

משתמשים ב-Health Connect דרך האפליקציה לנייד ולא דרך המכשיר.

Goals API

מטרות הן יעדים באפליקציית Google Fit שהמשתמשים יכולים להגדיר לעצמם. הם עוזרים לעודד את המשתמשים להישאר פעילים כל יום. בפרופיל שלהם, המשתמשים יכולים לשנות את מספר הצעדים ואת דק' האימון הקרדיו שהם רוצים להשיג בכל יום. פלטפורמת Fit מתעדת את היעדים שלהם ומעקב אחרי הפעילות היומית שלהם בהשוואה ליעדים האלה באמצעות Goals API.

טלפון Wear
אין ממשק API חלופי זמין. אין ממשק API חלופי זמין.

BLE API

האפליקציה יכולה למצוא מכשירים זמינים עם Bluetooth עם צריכת אנרגיה נמוכה (BLE) ולהוסיף נתוני חיישנים לפלטפורמת Google Fit באמצעות BLE API.

מעבר מה-BLE API לממשקי ה-API או לפלטפורמות הבאים:

טלפון Wear
שימוש ישיר ב-API של Bluetooth ל-Android. שימוש ישיר ב-API של Bluetooth ל-Android.