Untuk memastikan akurasi data dan agregasi yang konsisten, Google Health API memodernisasi cara aktivitas pengguna dilaporkan. Dengan memperkenalkan true zeros dan on-wrist filtering, API ini memungkinkan Anda membedakan secara akurat antara periode saat pengguna tidak bergerak dan saat pengguna tidak memakai perangkatnya.
True Zeros
True zero adalah titik data eksplisit yang menunjukkan bahwa pengguna memakai perangkatnya dan melacak secara aktif, tetapi mencatat nilai nol untuk metrik tertentu. Misalnya, pengguna mungkin mencatat 0 langkah atau 0 jarak selama interval 1 menit saat memakai perangkatnya.
Secara historis, data yang hilang tidak jelas. Data yang hilang dapat menandakan bahwa pengguna tidak bergerak atau perangkat tidak dipakai. API ini mengatasi masalah ini dengan menyimpan dan menampilkan nilai 0 secara eksplisit saat perangkat dipakai tetapi tidak aktif. Hal ini memastikan Anda dapat membedakan dengan jelas antara periode tidak bergerak saat perangkat dipakai dan data yang hilang.
Pemfilteran saat perangkat dipakai
Pemfilteran saat perangkat dipakai adalah proses mengidentifikasi apakah pengguna memakai perangkatnya secara fisik. Hal ini memungkinkan API memfilter data asing, seperti langkah "phantom" yang dicatat karena getaran kendaraan saat perangkat berada di dalam tas.
Jenis data yang didukung
Jenis data berikut mendukung perilaku true zero dan pemfilteran saat perangkat dipakai:
- Ketinggian
- Jarak
- Lantai
- Langkah
- Total Kalori
Dampak pada aplikasi Anda
Penerapan true zero meningkatkan akurasi interpretasi celah data dan penghitungan metrik, seperti rata-rata harian.
Perilaku daftar dan rollup
Secara default, Google Health API hanya menampilkan data saat perangkat dipakai untuk jenis data berikut:
- Operasi daftar: Hanya menampilkan titik data untuk periode saat perangkat dipakai. Celah dalam daftar menunjukkan bahwa perangkat tidak dipakai atau tidak disinkronkan.
- Operasi rollup: Nol dalam respons menandakan true zero (pengguna memakai perangkat tetapi tidak bergerak). Jika perangkat pelacak tidak dipakai selama interval tertentu, API tidak akan menampilkan data untuk jendela rollup tersebut.
Perbandingan dengan Fitbit Web API
Fitbit Web API sering menampilkan data, termasuk nol, meskipun perangkat pelacak tidak dipakai. Google Health API memberikan representasi gerakan yang lebih akurat.
| Fitur | Fitbit Web API | Google Health API |
|---|---|---|
| Ambiguitas Tidak Aktif | Data yang hilang dapat berarti tidak aktif atau tidak dipakai. | True zero secara eksplisit menunjukkan tidak aktif saat dipakai. |
| Celah Data | Celah data dapat ditetapkan secara default ke offset UTC. | Penyimpanan eksplisit mengatasi masalah zona waktu dan waktu sipil. |
| Pemfilteran | Pemfilteran saat perangkat dipakai terbatas. | Pemfilteran saat perangkat dipakai yang ketat memastikan akurasi fisiologis. |