Mengembangkan Pengalaman Langkah dengan Google Health API

Google Health API melacak data langkah dan aktivitas pengguna menggunakan jenis data interval steps. Jumlah langkah mewakili pengukuran dasar aktivitas fisik harian, membantu developer melacak progres kebugaran, menghitung pengeluaran energi, dan membuat ringkasan aktivitas harian yang ditampilkan kepada pengguna.

Pahami cara membaca dan menyusun metrik jumlah langkah di aplikasi Anda untuk memberikan pengalaman terbaik bagi pengguna.

Jenis data yang didukung

API ini mendukung jenis data berikut untuk melacak jumlah langkah:

Tabel: Jenis data langkah-langkah Google Health API

Jenis data   dataType Parameter   filter	Jenis catatan	Operasi yang tersedia	Cakupan	Dukungan webhook	Dukungan nol sebenarnya
Langkah-langkah   steps   steps	Interval	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

Bagian berikut memberikan detail teknis untuk jenis data steps, termasuk contoh representasi REST dan panduan integrasi.

Cakupan yang diperlukan

Untuk mengakses jenis data ini, aplikasi Anda harus meminta cakupan OAuth berikut:

• Baca: https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly
• Menulis: https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly

Panduan

Saat mengintegrasikan pelacakan langkah ke dalam aplikasi Anda, ikuti panduan desain dan penerapan berikut.

Ringkasan harian

Untuk menggabungkan jumlah langkah harian secara akurat saat bepergian, perubahan zona waktu, atau waktu musim panas, jangan lakukan penghitungan durasi sisi klien. Sebagai gantinya, kueri endpoint dailyRollUp yang merekonsiliasi kesenjangan data fisik secara otomatis menggunakan selisih UTC. Penggabungan menampilkan StepsRollupValue yang berisi kolom countSum, yang merepresentasikan total langkah yang terakumulasi untuk hari yang diminta.

Menggambar antarmuka pengguna (Rekonsiliasi)

Saat membuat elemen antarmuka pengguna untuk menampilkan data langkah, gunakan endpoint reconcile. Jika beberapa sumber data (seperti smartwatch dan ponsel) telah mencatat langkah secara bersamaan, endpoint reconcile akan menyelesaikan konflik dan menggabungkan aliran untuk menampilkan satu aliran data yang telah disesuaikan.

Pelacakan dan histogram intraday

Untuk menampilkan aktivitas pengguna yang mendetail sepanjang hari (seperti diagram dan grafik):

• Histogram langkah per jam: Buat kueri endpoint rollUp, dengan menentukan durasi (misalnya, 3600s selama 1 jam) menggunakan parameter windowSize.
• Semua data langkah: Gunakan endpoint list untuk mengambil data langkah mentah yang paling terperinci.

Endpoint rollUp dan reconcile menerima parameter kueri dataSourceFamily, sehingga Anda dapat memfilter data dari grup sumber tertentu.

Sinkronisasi real-time menggunakan webhook

Berlangganan koleksi jenis data steps untuk mendapatkan notifikasi secara real-time saat data langkah baru diimpor atau disinkronkan. Daripada melakukan polling pada endpoint REST, perbarui dasbor sisi klien secara dinamis sebagai respons terhadap notifikasi webhook ini. Untuk mengetahui detail cara menyiapkan langganan, lihat Langganan webhook.

Menangani nol sebenarnya

Google Health API menerapkan nol sebenarnya untuk menyelesaikan interval tidak aktif. Jika pengguna aktif atau memakai pelacak, tetapi tidak berjalan, pelacak akan menulis interval langkah eksplisit dengan count "0". Hal ini memungkinkan Anda membedakan antara periode saat pengguna tidak melakukan langkah apa pun saat memakai perangkat dan saat mereka tidak memakainya sama sekali. Lihat panduan Kehadiran data dan nol sebenarnya untuk mengetahui detail selengkapnya.