Keberadaan data dan nol sebenarnya

Untuk memastikan akurasi data dan penggabungan yang konsisten, Google Health API memodernisasi cara pelaporan aktivitas pengguna. Dengan memperkenalkan true zeros dan on-wrist filtering, API ini memungkinkan Anda membedakan secara akurat antara periode saat pengguna tidak bergerak dan saat mereka tidak memakai perangkat.

Nol Sejati

Nol sebenarnya adalah titik data eksplisit yang menunjukkan bahwa pengguna memakai perangkatnya dan melacak secara aktif, tetapi mencatat nilai nol untuk metrik tertentu. Misalnya, pengguna dapat mencatat 0 langkah atau 0 jarak selama interval 1 menit saat memakai perangkat.

Secara historis, data yang hilang tidak jelas. Hal ini dapat menandakan bahwa pengguna tidak aktif atau perangkat tidak dikenakan di pergelangan tangan. API ini menyelesaikannya dengan menyimpan dan menampilkan nilai 0 secara eksplisit saat perangkat dipakai, tetapi tidak aktif. Hal ini memastikan Anda dapat membedakan dengan jelas antara periode saat perangkat dipakai di pergelangan tangan dan tidak bergerak, serta data yang hilang.

Pemfilteran di smartwatch

Pemfilteran di pergelangan tangan adalah proses mengidentifikasi apakah pengguna secara fisik memakai perangkatnya. Hal ini memungkinkan API memfilter data yang tidak relevan, seperti langkah "phantom" yang direkam karena getaran kendaraan saat perangkat berada di dalam tas.

Jenis data yang didukung

Jenis data berikut mendukung perilaku nol sebenarnya dan pemfilteran di perangkat wearable:

• Ketinggian
• Jarak
• Lantai
• Langkah
• Total Kalori

Dampak pada aplikasi Anda

Penerapan nol sebenarnya meningkatkan akurasi interpretasi kesenjangan data dan penghitungan metrik, seperti rata-rata harian.

Perilaku daftar dan penggabungan

Secara default, Google Health API hanya menampilkan data di perangkat wearable untuk jenis data berikut:

• Operasi daftar: Menampilkan titik data hanya untuk periode saat perangkat dipakai.
  • Kesenjangan data: Kesenjangan dan data yang hilang dalam daftar menunjukkan bahwa perangkat tidak terpasang di pergelangan tangan atau tidak disinkronkan.
  • Data kosong: Titik data saat pengguna memakai perangkat, tetapi tidak ada aktivitas (nol sebenarnya) ditampilkan dengan informasi dataSource dan interval atau stempel waktu normal, tetapi tidak menyertakan kolom khusus metrik (seperti properti count). Nilai ini harus ditafsirkan sebagai nilai nol.
• Operasi penggabungan: Angka nol dalam respons menandakan nol sebenarnya (pengguna memakai perangkat, tetapi tidak bergerak). Jika perangkat pelacak tidak dipakai selama interval tertentu, API tidak akan menampilkan data untuk jendela penggabungan tersebut.

Dalam operasi list, sinkronisasi perangkat terhubung yang berurutan juga dapat menghasilkan interval yang tumpang-tindih saat algoritma di perangkat mengelompokkan ulang telemetri sensor mentah. Untuk mengetahui informasi selengkapnya tentang menangani tumpang-tindih interval, lihat Panduan pengelolaan data.

Perbandingan dengan Fitbit Web API

Fitbit Web API sering kali menampilkan data, termasuk nol, meskipun perangkat pelacak tidak dipakai. Google Health API memberikan representasi gerakan yang lebih akurat.

Fitur	Fitur Fitbit Web API	Google Health API
Ambiguitas Tidak Aktif	Data yang hilang dapat berarti tidak ada aktivitas atau tidak dipakai di pergelangan tangan.	Nilai nol yang sebenarnya secara eksplisit menunjukkan tidak ada aktivitas saat dipakai.
Kesenjangan Data	Kesenjangan data dapat ditetapkan secara default ke offset UTC.	Penyimpanan eksplisit menyelesaikan masalah zona waktu dan waktu sipil.
Pemfilteran	Pemfilteran terbatas di smartwatch.	Pemfilteran ketat di pergelangan tangan memastikan akurasi fisiologis.