מדריך להעברת נתונים מ-Fit

ממשקי Google Fit API הוצאו משימוש, והשירות שלהם יסתיים בסוף שנת 2026. ‫Google מציעה מספר מוצרים ושירותים בתחום הבריאות והרווחה, שיעזרו למשתמשים להמשיך להשיג את המטרות שלהם אחרי הוצאת המוצר משימוש.

שימו לב: התמיכה ב-Google Fit API (כולל API בארכיטקטורת REST) תסתיים בסוף 2026. מומלץ לעבור ל-Google Health API לשילובים מבוססי-ענן או ל-Health Connect למעקב אחר צעדים ולאפליקציות שמתמקדות בנייד.

ההנחיות הבאות מראות לאיזה שירות כדאי לעבור בהתאם לאופן השימוש שלכם בממשקי Google Fit API.

הבחירה של ה-API צריכה להתבסס על סוג האפליקציה ועל הצרכים הספציפיים שלכם בנוגע לנתונים.

לפי סוג האפליקציה

סוג האפליקציה הנתיב המומלץ סיבה עיקרית
אפליקציה למעקב אחר צעדים Health Connect קריאה של נתוני צעדים מצטברים ממקורות שונים, עם דגש על ניידות.
אפליקציה נלווית לצמידי כושר Google Health API פלטפורמה שמתמקדת באינטרנט ודורשת OAuth לשילוב משתמשים.
פלטפורמה לבריאות וכושר Google Health API ו-Health Connect אפשר להשתמש ב-Google Health API לנתונים במכשיר של Fitbit או Google, וב-Health Connect לנתונים מצטברים במכשיר.

דרך השילוב הנוכחי

השילוב הנוכחי הנתיב המומלץ זמינות
Google Fit ‏ (Android ו-API בארכיטקטורת REST) Google Health API זמין
קריאת נתונים של צעדים בנייד (באמצעות Google Fit Recording API) Health Connect זמין
Fit API ב-Wear OS Health Services זמין
Fitbit Web API Google Health API זמין
Recording API on Mobile Health Connect זמין
Health Connect שומרים על השילוב הקיים או מוסיפים את Google Health API זמין

השוואות טכניות

בקטעים הבאים מוצגת השוואה טכנית בין Google Fit APIs, ‏ Google Health API ו-Health Connect, כדי לעזור לכם לבחור את נתיב ההעברה המתאים.

ההבדלים בין Fit API לבין Google Health API

כדאי להשתמש בנתיב הזה אם האפליקציה שלכם היא פלטפורמה מבוססת-אינטרנט או שהיא דורשת אינטראקציות בין שרתים (S2S).

תכונה Fit API ‏ (Android/REST) Google Health API
הגדרת הפרויקט Google Cloud Console יצירת פרויקט ב-Google Cloud
הגדרת OAuth סוג האפליקציה ל-Android או לאינטרנט סוג אפליקציית האינטרנט
ארכיטקטורת נתונים com.google סוגים עם קידומת סוגי נתונים מאוחדים של Google Health API
רישום אפליקציה יצירת פרויקט ב-Google Cloud יצירת פרויקט ב-Google Cloud והפעלת Google Health API

‫Fit API לעומת Health Connect

משתמשים בנתיב הזה באפליקציות ל-Android שמותאמות לנייד, שקוראות מדדים מקומיים במכשיר.

תכונה Fit API ל-Android Health Connect
הרשמה Google Cloud Console פרויקט בחנות Play והצהרה לגבי אפליקציות בתחום הבריאות
אימות נדרש OAuth 2.0 לא נדרש OAuth (הרשאות במכשיר)
אחסון הנתונים ממוקד בענן ממוקד במכשיר (במכשיר)
קהל מפתחי Android מדור קודם מפתחים מודרניים של אפליקציות ל-Android
הרשאות היקפי הרשאות של OAuth הרשאות במניפסט של Android

שילובים של Fit API

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

אפליקציות שמשתמשות ב-Fit Recording API כדי לתעד צעדים

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

כדי לבצע מיגרציה מ-Fit Recording API:

טבלה 1: שלבי המעבר מ-Fit Recording API
טלפון Wear
  1. כדי להציג את המספר הכולל של הצעדים, צריך להוסיף את Health Connect לאפליקציה. המספר הכולל כולל צעדים מהנייד (Android 14 ואילך) וצעדים מאפליקציות וממכשירים אחרים.
  2. כדי להמשיך להציג נתוני צעדים מקומיים באפליקציה, צריך להטמיע כתיבת נתונים באמצעות API הכתיבה של Health Connect.

שימוש ב-Health Services:

  • PassiveMonitoringClient
  • ExerciseClient

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

אפליקציות שמשתמשות ב-History API כדי לקרוא או לכתוב נתונים במאגר נתוני הכושר

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

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

טבלה 2: שלבי המעבר מ-Fit History API
טלפון Wear

מעבר אל Google Health API.

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

אפליקציות שמשתמשות ב-Sensor API כדי להציג נתונים של אימוני כושר בזמן אמת

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

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

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

טבלה 3: שלבי המעבר מ-Fit Sensor API
טלפון Wear

שימוש ב-חיישנים, ספק מיקום משולב API

שימוש ב-Health Services ב-Wear OS:‏

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    או להשתמש ב-SensorManager, FusedLocationProvider

אפליקציות שמשתמשות ב-Session API כדי לספק סיכומי פעילות

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

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

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

טבלה 4: שלבי המעבר מ-Fit Session API
טלפון Wear

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

קריאה/כתיבה: מעבר ל-Google Health API

התחלה/הפסקה: שימוש בשירותי בריאות (ExerciseClient)

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

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

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

אפליקציות שמשתמשות ב-Goals API

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

טבלה 5: הנחיות להעברת נתונים עבור Fit Goals API
טלפון Wear
אין API חלופי זמין. אין API חלופי זמין.

אפליקציות שמשתמשות ב-BLE API

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

כדי לבצע מיגרציה מ-BLE API:

טבלה 6: שלבי ההעברה מ-Fit BLE API
טלפון Wear
שימוש ישיר בממשקי Android Bluetooth API. שימוש ישיר בממשקי Android Bluetooth API.

תכונות שהוצאו משימוש

לתכונות הבאות אין תחליף ישיר ב-API. שימוש בממשקי ה-API המומלצים של Android:

  • Sensor API: אפשר להשתמש ב-Android Sensors framework או ב-Fused Location Provider API כדי לקבל נתונים גולמיים בזמן אמת.
  • Goals API: אין API חלופי. ניהול מעקב אחרי יעדים ויעדי פעילות יומיים במסגרת הלוגיקה של האפליקציה.
  • Bluetooth Low Energy (BLE) API: שימוש ישיר בממשקי ה-API של Android Bluetooth כדי לתקשר עם חומרה.

שילובי אפליקציות מתאימים

אם האפליקציה שלכם מתחברת ל-Google Fit כדי לשתף נתונים, כדאי לעיין בהנחיות שבקטעים הבאים בנושא העברת משתמשים קיימים וחדשים אל Health Connect או אל Google Health API:

משתמשים קיימים באפליקציה

אם ממשק המשתמש של האפליקציה כולל דרך למשתמשים להתחבר ל-Google Fit (או אם האפליקציה שלכם נכללת ברשימה של אפליקציות שפועלות עם Google Fit), אתם יכולים להמשיך לתחזק את השילוב של האפליקציה עם Google Fit עבור משתמשים קיימים.

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

טבלה 7: המלצות למשתמשים קיימים עם שילובים של אפליקציית Fit
כדאי לבדוקכך עושים זאת סגירהלא מומלץ
מציעים את Health Connect או את Google Health API כאפשרות חדשה באפליקציה.

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

סנכרון עם Health Connect

מבקשים מהמשתמשים להתנתק מ-Google Fit.

ניתוק מ-Health Connect

משתמשים חדשים באפליקציה

כדי להציע חוויה דומה למשתמשים חדשים באפליקציה, מומלץ ליצור שילוב עם Health Connect או עם Google Health API.

‫Health Connect מאפשרת גישה למקורות ולסוגים חדשים של נתונים כדי לספק חוויה עשירה יותר למשתמשים, עם נתונים שמאוחסנים בצורה מאובטחת במכשיר. ‫Google Health API מספק פלטפורמה שמתמקדת באינטרנט לנתונים של מכשירי Fitbit ו-Google.

טבלה 8: המלצות למשתמשים חדשים עם שילובים של אפליקציות Fit
כדאי לבדוקכך עושים זאת סגירהלא מומלץ
כוללים את Health Connect או את Google Health API בתהליך ההגדרה של האפליקציה. להציע את Fit כאפליקציה שהמשתמשים יכולים לקשר אליה ברגע ש-Health Connect זמין.