Panduan migrasi Fit

Google Fit API akan didukung hingga akhir tahun 2026. Google menawarkan beberapa produk dan layanan kesehatan dan kebugaran untuk membantu pengguna Anda terus mencapai sasaran mereka setelah penghentian.

Perhatian: Google Fit API (termasuk REST API) hanya akan didukung hingga akhir tahun 2026. Sebaiknya migrasikan 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 tertentu.

Menurut jenis aplikasi

Jenis aplikasi Jalur yang direkomendasikan Alasan utama
Aplikasi Pelacakan Langkah Health Connect Pembacaan data langkah gabungan yang berpusat pada perangkat seluler dari berbagai sumber.
Aplikasi Pendamping Pelacak Kebugaran Google Health API Platform yang berpusat pada web dan memerlukan OAuth untuk integrasi pengguna.
Platform Kesehatan dan Kebugaran The 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
Fit History API dan Fit Session API Google Health API Tersedia
Membaca langkah seluler (dengan Google Fit Recording API) Health Connect Tersedia
Fit API di Wear OS Fitur Kesehatan Tersedia
Fitbit Web API Google Health API Tersedia
Health Connect Pertahankan integrasi yang ada atau tambahkan 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
Penyiapan Project Konsol Google Cloud Membuat project Google Cloud
Konfigurasi OAuth Jenis aplikasi Android atau Web Jenis aplikasi web
Arsitektur Data Jenis dengan awalan com.google Jenis data Google Health API terpadu
Pendaftaran Aplikasi Membuat project Google Cloud Membuat project Google Cloud dan mengaktifkan Google Health API

Fit API versus Health Connect

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

Fitur Fit API untuk Android Health Connect
Pendaftaran Konsol Google Cloud Project Play Store dan deklarasi aplikasi kesehatan
Autentikasi OAuth 2.0 diperlukan Tidak memerlukan OAuth (izin di perangkat)
Penyimpanan data Berpusat pada cloud Berpusat pada perangkat (di perangkat)
Audiens Developer Android lama Developer seluler Modern Android
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 menyertakan 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 umum digunakan untuk merekam 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. Total ini mencakup langkah seluler (Android 14 atau yang lebih baru) dan langkah dari aplikasi serta perangkat lainnya.
  2. Untuk terus menampilkan data langkah lokal di aplikasi Anda, terapkan penulisan data menggunakan write API Health Connect.

Gunakan Fitur Kesehatan:

  • PassiveMonitoringClient
  • ExerciseClient

Lihat dokumentasi Fitur 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

Beralih 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

Gunakan Fitur Kesehatan di Wear OS:

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    Atau gunakan SensorManager, FusedLocationProvider

Aplikasi yang menggunakan Session API untuk memberikan ringkasan aktivitas

Session 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

Goals adalah target di aplikasi Google Fit yang dapat disetel sendiri oleh pengguna untuk metrik mereka seperti langkah dan poin kesehatan. 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 penggantian 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 sasaran dan target aktivitas harian dalam logika aplikasi Anda.
  • Bluetooth Hemat Energi (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 cara memigrasikan pengguna yang ada dan baru ke Health Connect atau Google Health API di bagian ini:

Pengguna aplikasi Anda yang sudah ada

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 integrasi aplikasi Fit Anda akan dihentikan, dan opsi terbaik untuk mempertahankan pengalaman pengguna. Sementara itu, Anda dapat menghubungi kami.

Tabel 7: Rekomendasi untuk pengguna yang sudah ada dengan integrasi aplikasi Fit
checkLakukan hal ini closeJangan lakukan hal ini
Tawarkan Health Connect atau Google Health API sebagai opsi baru di aplikasi Anda.

Fokus 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 yang 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 lengkap bagi pengguna, dengan data yang disimpan secara aman di perangkat. Google Health API menyediakan platform yang berpusat pada web untuk data perangkat Fitbit dan Google.

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