Panduan migrasi Fit

Google Fit API tidak digunakan lagi dan dijadwalkan untuk dihentikan layanannya pada akhir tahun 2026. Google menawarkan beberapa produk dan layanan kesehatan untuk membantu pengguna Anda terus mencapai tujuan mereka setelah penghentian penggunaan.

Perhatian: Google Fit API (termasuk REST API) hanya akan didukung hingga akhir tahun 2026. Sebaiknya lakukan migrasi ke Google Health API untuk integrasi berbasis cloud atau Health Connect untuk pelacakan langkah dan aplikasi yang mengutamakan perangkat seluler.

Panduan berikut menunjukkan layanan yang akan digunakan untuk bermigrasi berdasarkan cara Anda menggunakan Google Fit API.

Pilihan API Anda harus didasarkan pada jenis aplikasi dan kebutuhan data spesifik Anda.

Menurut Jenis Aplikasi

Jenis Aplikasi Jalur yang Direkomendasikan Alasan Utama
Aplikasi Pelacakan Langkah Health Connect Pembacaan data langkah yang digabungkan dari berbagai sumber yang berfokus pada perangkat seluler.
Aplikasi Pendamping Pelacak Kebugaran Google Health API Platform yang berfokus pada web yang memerlukan OAuth untuk integrasi pengguna.
Platform Kesehatan dan Kebugaran Google Health API & Health Connect Gunakan Google Health API untuk data perangkat Fitbit/Google dan Health Connect untuk data gabungan di perangkat.

Menurut integrasi saat ini

Integrasi Saat Ini Jalur yang Direkomendasikan Ketersediaan
Google Fit (Android & REST API) Google Health API Tersedia
Membaca langkah kaki di perangkat seluler (dengan Google Fit Recording API) Health Connect Tersedia
Fit API di Wear OS Fitur Kesehatan Tersedia
Fitur Fitbit Web API Google Health API Tersedia
Recording API di Perangkat Seluler Health Connect Tersedia
Health Connect Mempertahankan integrasi yang ada atau menambahkan Google Health API Tersedia

Perbandingan teknis

Bagian berikut memberikan perbandingan teknis antara Google Fit API, Google Health API, dan Health Connect untuk membantu Anda memilih jalur migrasi yang tepat.

Fit API versus Google Health API

Gunakan jalur ini jika aplikasi Anda adalah platform berbasis web atau memerlukan interaksi server-ke-server (S2S).

Fitur Fit API (Android/REST) Google Health API
Persiapan Proyek Konsol Google Cloud Buat project Google Cloud
Konfigurasi OAuth Jenis aplikasi Android atau Web Jenis aplikasi web
Arsitektur Data Jenis yang diawali com.google Jenis data Google Health API terpadu
Pendaftaran Aplikasi Buat project Google Cloud Buat project Google Cloud dan aktifkan Google Health API

Fit API versus Health Connect

Gunakan jalur ini untuk aplikasi Android yang mengutamakan seluler yang membaca metrik perangkat lokal.

Fitur Fit API untuk Android Health Connect
Pendaftaran Konsol Google Cloud Project Play Store dan pernyataan aplikasi kesehatan
Autentikasi OAuth 2.0 diperlukan Tidak memerlukan OAuth (izin di perangkat)
Penyimpanan data Berfokus pada cloud Berfokus pada perangkat (di perangkat)
Audiens Developer Android lama Developer seluler Android modern
Izin Cakupan OAuth Izin manifes Android

Integrasi Fit API

Bagian berikut memberikan panduan tentang cara bermigrasi dari setiap Google Fit API. Jika integrasi Anda juga mencakup elemen UI yang terhubung ke aplikasi Google Fit, lihat Panduan integrasi aplikasi Fit untuk panduan tambahan.

Aplikasi yang menggunakan Fit Recording API untuk merekam langkah

Fit Recording API memungkinkan aplikasi Anda meminta penyimpanan otomatis data sensor secara efisien baterai dengan membuat langganan. Setiap langganan menghubungkan aplikasi Android ke jenis data kebugaran atau sumber data tertentu, dan jenis data Step biasanya digunakan untuk mencatat langkah.

Ikuti langkah-langkah berikut untuk bermigrasi dari Fit Recording API:

Tabel 1: Langkah-langkah migrasi dari Fit Recording API
Ponsel Wear
  1. Untuk menampilkan jumlah langkah total, tambahkan Health Connect ke aplikasi Anda. Totalnya mencakup langkah seluler (Android 14 atau yang lebih tinggi) dan langkah dari aplikasi dan perangkat lain.
  2. Untuk terus menampilkan data langkah lokal di aplikasi Anda, terapkan penulisan data menggunakan Health Connect Write API.

Menggunakan Fitur Kesehatan:

  • PassiveMonitoringClient
  • ExerciseClient

Lihat dokumentasi Layanan Kesehatan untuk mengetahui perbedaan antara keduanya.

Aplikasi yang menggunakan History API untuk membaca atau menulis data ke penyimpanan kebugaran

History API memungkinkan aplikasi Anda melakukan operasi massal di penyimpanan kebugaran. Operasi ini mencakup membaca, memasukkan, memperbarui, dan menghapus data historis kesehatan dan kebugaran.

Ikuti langkah-langkah berikut untuk bermigrasi dari History API:

Tabel 2: Langkah-langkah migrasi dari Fit History API
Ponsel Wear

Transisi ke Google Health API.

Tidak berlaku. Gunakan Health Connect dari aplikasi seluler, bukan dari perangkat wearable.

Aplikasi yang menggunakan Sensor API untuk menampilkan data kebugaran real-time

Sensor API memungkinkan Anda membaca data sensor mentah di aplikasi secara real time. Sensor API melakukan hal berikut:

  • Mencantumkan sumber data yang tersedia di perangkat dan di perangkat pendamping.
  • Mendaftarkan pemroses untuk menerima data sensor mentah.
  • Membatalkan pendaftaran pemroses sehingga tidak lagi menerima data sensor mentah.

Ikuti langkah-langkah berikut untuk bermigrasi dari Sensor API:

Tabel 3: Langkah-langkah migrasi dari Fit Sensor API
Ponsel Wear

Gunakan Sensor, Fused Location Provider API

Menggunakan Fitur Kesehatan di Wear OS:

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    Atau gunakan SensorManager, FusedLocationProvider

Aplikasi yang menggunakan Session API untuk memberikan ringkasan aktivitas

Sesi menunjukkan interval waktu saat pengguna melakukan aktivitas kebugaran.

Session API memungkinkan aplikasi Anda membuat sesi di penyimpanan kebugaran.

Ikuti langkah-langkah berikut untuk bermigrasi dari Session API:

Tabel 4: Langkah-langkah migrasi dari Fit Session API
Ponsel Wear

Mulai/berhenti: Tidak berlaku. Aplikasi harus melacak status sesi yang sedang berlangsung secara internal.

Baca/tulis: Beralih ke Google Health API.

Mulai/berhenti: Gunakan Fitur Kesehatan (ExerciseClient)

Baca/tulis: Gunakan Health Connect dengan aplikasi seluler Anda.

Untuk alur kerja tertentu, kami menyarankan hal berikut:

  • Menyisipkan sesi: Developer harus menggunakan Health Connect dengan aplikasi seluler mereka dan menyisipkan ExerciseSessionRecord atau SleepSessionRecord.

Aplikasi yang menggunakan Goals API

Sasaran adalah target di aplikasi Google Fit yang dapat disetel sendiri oleh pengguna untuk metrik mereka seperti langkah dan poin kardio. Platform Fit mencatat sasaran dan melacak aktivitas harian mereka menggunakan Goals API.

Tabel 5: Panduan migrasi untuk Fit Goals API
Ponsel Wear
Tidak ada API pengganti yang tersedia. Tidak ada API pengganti yang tersedia.

Aplikasi yang menggunakan BLE API

Aplikasi Anda dapat menemukan perangkat Bluetooth Hemat Energi (BLE) yang tersedia dan memasukkan data sensor ke platform Google Fit menggunakan BLE API.

Ikuti langkah-langkah berikut untuk bermigrasi dari BLE API:

Tabel 6: Langkah-langkah migrasi dari Fit BLE API
Ponsel Wear
Gunakan Android Bluetooth API secara langsung. Gunakan Android Bluetooth API secara langsung.

Fitur yang tidak digunakan lagi

Fitur berikut tidak memiliki pengganti API langsung. Gunakan API standar Android yang direkomendasikan:

  • Sensor API: Gunakan framework Sensor Android atau Fused Location Provider API untuk data mentah real-time.
  • Goals API: Tidak ada API pengganti yang tersedia. Kelola pelacakan target dan target aktivitas harian dalam logika aplikasi Anda.
  • Bluetooth Low Energy (BLE) API: Gunakan Android Bluetooth API secara langsung untuk berkomunikasi dengan hardware.

Integrasi aplikasi Fit

Jika aplikasi Anda terhubung ke Google Fit untuk berbagi data, ikuti panduan tentang memigrasikan pengguna lama dan baru ke Health Connect atau Google Health API di bagian berikut:

Pengguna lama aplikasi Anda

Jika UI aplikasi Anda menyertakan cara bagi pengguna untuk terhubung ke Google Fit (atau jika aplikasi Anda disertakan dalam daftar Aplikasi yang kompatibel dengan Google Fit), Anda dapat terus mempertahankan integrasi aplikasi Fit untuk pengguna saat ini.

Kami akan terus memperbarui bagian ini dengan informasi tentang kapan menghentikan penggunaan integrasi aplikasi Fit Anda, dan opsi terbaik untuk mempertahankan pengalaman pengguna Anda. Sementara itu, Anda dapat menghubungi kami.

Tabel 7: Rekomendasi untuk pengguna lama dengan integrasi aplikasi Fit
periksaLakukan ini tutupJangan lakukan ini
Tawarkan Health Connect atau Google Health API sebagai opsi baru di aplikasi Anda.

Berfokus pada manfaat pengguna seperti data dan insight yang lebih lengkap, privasi, dan keamanan.

Sinkronkan dengan Health Connect

Minta pengguna untuk memutuskan sambungan dari Google Fit.

Berhenti hubungkan Health Connect

Pengguna baru aplikasi Anda

Untuk menawarkan pengalaman serupa kepada pengguna baru aplikasi Anda, sebaiknya buat integrasi dengan Health Connect atau Google Health API.

Health Connect menawarkan akses ke sumber dan jenis data baru untuk memberikan pengalaman yang lebih kaya bagi pengguna, dengan data yang disimpan secara aman di perangkat. Google Health API menyediakan platform yang berfokus pada web untuk data perangkat Fitbit dan Google.

Tabel 8: Rekomendasi untuk pengguna baru dengan integrasi aplikasi Fit
periksaLakukan ini tutupJangan lakukan ini
Sertakan Health Connect atau Google Health API dalam alur penyiapan aplikasi Anda. Menawarkan Fit sebagai aplikasi yang dapat dihubungkan pengguna setelah Health Connect tersedia.