Interfejsy Google Fit API będą obsługiwane do końca 2026 roku. Google oferuje kilka produktów i usług związanych ze zdrowiem i dobrym samopoczuciem, które pomogą użytkownikom w osiąganiu celów po wycofaniu interfejsów.
Uwaga: interfejs Google Fit API (w tym interfejs REST API) będzie obsługiwany tylko do końca 2026 roku. Zalecamy migrację do interfejsu Google Health API w przypadku integracji opartych na chmurze lub do Health Connect w przypadku aplikacji mobilnych i śledzenia kroków.
Poniższe wytyczne pokazują, do której usługi należy przeprowadzić migrację w zależności od sposobu korzystania z interfejsów Google Fit API.
Zalecane ścieżki migracji
Wybór interfejsu API powinien zależeć od typu aplikacji i konkretnych potrzeb związanych z danymi.
Według typu aplikacji
| Typ aplikacji | Zalecana ścieżka | Główny powód |
|---|---|---|
| Aplikacja do śledzenia kroków | Health Connect | Odczytywanie zagregowanych danych o krokach z różnych źródeł w sposób dostosowany do urządzeń mobilnych. |
| Aplikacja towarzysząca do trackerów fitness | Google Health API | Platforma internetowa wymagająca protokołu OAuth do integracji z użytkownikiem. |
| Zdrowie i fitness | Google Health API i Health Connect | Użyj interfejsu Google Health API do danych z urządzeń Fitbit i Google oraz Health Connect do zagregowanych danych na urządzeniu. |
Według obecnej integracji
| Obecna integracja | Zalecana ścieżka | Dostępność |
|---|---|---|
| Fit History API i Fit Session API | Google Health API | Dostępna |
| Odczytywanie kroków na urządzeniu mobilnym (za pomocą interfejsu Google Fit Recording API) | Health Connect | Dostępna |
| Fit API na Wear OS | Funkcje dotyczące zdrowia | Dostępna |
| Fitbit Web API | Google Health API | Dostępna |
| Health Connect | Zachowaj obecną integrację lub dodaj interfejs Google Health API | Dostępna |
Porównanie techniczne
W kolejnych sekcjach znajdziesz porównanie techniczne interfejsów Google Fit API, Google Health API i Health Connect, które pomoże Ci wybrać odpowiednią ścieżkę migracji.
Porównanie interfejsu Fit API i Google Health API
Użyj tej ścieżki, jeśli Twoja aplikacja jest platformą internetową lub wymaga interakcji serwer-serwer (S2S).
| Funkcja | Fit API (Android/REST) | Google Health API |
|---|---|---|
| Konfiguracja projektu | Google Cloud Console | Utwórz projekt Google Cloud |
| Konfiguracja protokołu OAuth | Typ aplikacji na Androida lub aplikacji internetowej | Typ aplikacji internetowej |
| Architektura danych | Typy z prefiksem com.google |
Ujednolicone typy danych interfejsu Google Health API |
| Rejestracja aplikacji | Utwórz projekt Google Cloud | Utwórz projekt Google Cloud i włącz interfejs Google Health API |
Porównanie interfejsu Fit API i Health Connect
Użyj tej ścieżki w przypadku aplikacji na Androida, które są dostosowane do urządzeń mobilnych i odczytują dane z lokalnych czujników.
| Funkcja | Interfejs API Fit na Androida | Health Connect |
|---|---|---|
| Rejestracja | Google Cloud Console | Projekt w Sklepie Play i deklaracja aplikacji do dbania o zdrowie |
| Uwierzytelnianie | Wymagany protokół OAuth 2.0 | Nie jest wymagany protokół OAuth (uprawnienia na urządzeniu) |
| Przechowywanie danych | Oparte na chmurze | Oparte na urządzeniu (na urządzeniu) |
| Odbiorcy | Deweloperzy starszych wersji Androida | Deweloperzy aplikacji mobilnych na Androida |
| Uprawnienia | Zakresy protokołu OAuth | Uprawnienia w pliku manifestu Androida |
Integracje z interfejsem Fit API
W kolejnych sekcjach znajdziesz wskazówki dotyczące migracji z poszczególnych interfejsów Google Fit API. Jeśli integracja obejmuje też elementy interfejsu, które łączą się z aplikacją Google Fit, zapoznaj się z wytycznymi dotyczącymi integracji z aplikacją Fit.
Aplikacje korzystające z interfejsu Fit Recording API do rejestrowania kroków
Interfejs Fit Recording API umożliwia aplikacji żądanie automatycznego przechowywania danych z czujników w sposób oszczędzający baterię przez tworzenie subskrypcji.
Każda subskrypcja łączy aplikację na Androida z określonym typem danych o aktywności fizycznej lub źródłem danych, a typ danych Step jest powszechnie używany do rejestrowania kroków.
Aby przeprowadzić migrację z interfejsu Fit Recording API, wykonaj te czynności:
| Telefon | Wear |
|
Skorzystaj z funkcji dotyczących zdrowia:
Więcej informacji o różnicach między nimi znajdziesz w dokumentacji funkcji dotyczących zdrowia. |
Aplikacje korzystające z interfejsu History API do odczytywania lub zapisywania danych w magazynie informacji o aktywności fizycznej
History API umożliwia aplikacji wykonywanie operacji zbiorczych w magazynie informacji o aktywności fizycznej. Te operacje obejmują odczytywanie, wstawianie, aktualizowanie i usuwanie historycznych danych o zdrowiu i samopoczuciu.
Aby przeprowadzić migrację z interfejsu History API, wykonaj te czynności:
| Telefon | Wear |
|
Nie dotyczy. Używaj Health Connect w aplikacji mobilnej, a nie na urządzeniu do noszenia. |
Aplikacje korzystające z interfejsu Sensor API do wyświetlania danych o aktywności fizycznej w czasie rzeczywistym
Sensor API umożliwia odczytywanie nieprzetworzonych danych z czujników w aplikacji w czasie rzeczywistym. Sensor API wykonuje te czynności:
- Przechowuje listę źródeł danych dostępnych na urządzeniu i urządzeniach towarzyszących.
- Rejestruje detektory, które mają otrzymywać nieprzetworzone dane z czujników.
- Anuluje rejestrację detektorów, które mają już nie otrzymywać nieprzetworzonych danych z czujników.
Aby przeprowadzić migrację z interfejsu Sensor API, wykonaj te czynności:
| Telefon | Wear |
|
Użyj interfejsów API Sensors, Fused Location Provider. |
Skorzystaj z funkcji dotyczących zdrowia na Wear OS:
|
Aplikacje korzystające z interfejsu Session API do wyświetlania podsumowań aktywności
Sesje to przedziały czasu, w których użytkownicy wykonują aktywność związaną z fitnessem.
Session API umożliwia aplikacji tworzenie sesji w magazynie informacji o aktywności fizycznej.
Aby przeprowadzić migrację z interfejsu Session API, wykonaj te czynności:
| Telefon | Wear |
|
Start/stop: nie dotyczy. Aplikacja powinna śledzić stan trwających sesji wewnętrznie. Odczyt/zapis: Przejście na interfejs Google Health API. |
Start/stop: użyj funkcji dotyczących zdrowia (ExerciseClient). Odczyt/zapis: użyj Health Connect w aplikacji mobilnej. W przypadku konkretnych przepływów pracy zalecamy te działania:
|
Aplikacje korzystające z interfejsu Goals API
Cele to wartości docelowe w aplikacji Google Fit, które użytkownicy mogą ustawiać dla swoich danych, takich jak liczba kroków i punkty kardio. Platforma Fit rejestruje te cele i śledzi codzienną aktywność użytkowników w porównaniu z nimi za pomocą interfejsu Goals API.
| Telefon | Wear |
| Brak zastępczego interfejsu API. | Brak zastępczego interfejsu API. |
Aplikacje korzystające z interfejsu BLE API
Za pomocą interfejsu BLE API aplikacja może znajdować dostępne urządzenia Bluetooth Low Energy (BLE) i wstawiać dane z czujników do platformy Google Fit.
Aby przeprowadzić migrację z interfejsu BLE API, wykonaj te czynności:
| Telefon | Wear |
| Skorzystaj bezpośrednio z interfejsów Bluetooth API na Androidzie. | Skorzystaj bezpośrednio z interfejsów Bluetooth API na Androidzie. |
Funkcje wycofane
Te funkcje nie mają bezpośredniego odpowiednika w interfejsie API. Użyj zalecanych standardowych interfejsów API na Androidzie:
- Sensor API: użyj platformy Android Sensors lub interfejsu Fused Location Provider API, aby uzyskać nieprzetworzone dane w czasie rzeczywistym.
- Goals API: brak zastępczego interfejsu API. Zarządzaj śledzeniem celów i dziennymi celami aktywności w logice aplikacji.
- Bluetooth Low Energy (BLE) API: użyj bezpośrednio interfejsów Bluetooth API na Androidzie, aby komunikować się ze sprzętem.
Integracje z aplikacją Fit
Jeśli Twoja aplikacja łączy się z Google Fit w celu udostępniania danych, postępuj zgodnie ze wskazówkami dotyczącymi migracji obecnych i nowych użytkowników do Health Connect lub interfejsu Google Health API w tych sekcjach:
Obecni użytkownicy Twojej aplikacji
Jeśli interfejs Twojej aplikacji umożliwia użytkownikom łączenie się z Google Fit (lub jeśli Twoja aplikacja znajduje się na liście aplikacji współpracujących z Google Fit), możesz nadal obsługiwać integrację z aplikacją Fit dla obecnych użytkowników.
Będziemy aktualizować tę sekcję, aby poinformować Cię o tym, kiedy należy wycofać integrację aplikacji Fit i jakie są najlepsze opcje utrzymania komfortu użytkowników. W międzyczasie możesz skontaktować się z nami.
| ikona potwierdzeniaZrób to | ikona zakazuNie rób tego |
| Zaoferuj Health Connect lub interfejs Google Health API jako nową opcję w aplikacji.
Skup się na korzyściach dla użytkowników, takich jak bogatsze dane i statystyki, prywatność i bezpieczeństwo.
|
Poproś użytkowników o odłączenie się od Google Fit.
|
Nowi użytkownicy aplikacji
Aby zapewnić nowym użytkownikom podobne wrażenia, zalecamy utworzenie integracji z Health Connect lub interfejsem Google Health API.
Health Connect zapewnia dostęp do nowych źródeł i typów danych, co pozwala użytkownikom korzystać z bogatszych funkcji. Dane są bezpiecznie przechowywane na urządzeniu. Google Health API to platforma internetowa do obsługi danych z urządzeń Fitbit i Google.
| ikona potwierdzeniaZrób to | ikona zakazuNie rób tego |
| Uwzględnij Health Connect lub interfejs Google Health API w procesie konfiguracji aplikacji. | Zaoferuj aplikację Fit jako aplikację, z którą użytkownicy mogą się połączyć, gdy Health Connect będzie dostępna. |