Google Health API, veri doğruluğunu ve tutarlı toplamaları sağlamak için kullanıcı etkinliğinin raporlanma şeklini modernleştirir. true zeros ve on-wrist filtering'yi kullanıma sunan API, kullanıcının hareketsiz olduğu dönemlerle cihazını takmadığı dönemleri doğru şekilde ayırt etmenizi sağlar.
True Zeros
Gerçek sıfır, kullanıcının cihazını taktığını ve aktif olarak takip yaptığını ancak belirli bir metrik için sıfır değeri kaydettiğini gösteren açık bir veri noktasıdır. Örneğin, bir kullanıcı cihazını takarken 1 dakikalık aralıkta 0 adım veya 0 mesafe kaydedebilir.
Geçmişte, eksik veriler belirsizdi. Bu, kullanıcının hareketsiz kaldığını veya cihazın bilekte olmadığını gösterebilir. API, cihaz takılıyken ancak etkin değilken 0 değerini açıkça depolayıp döndürerek bu sorunu çözer. Bu sayede, bilekte hareketsiz kalma sürelerini ve eksik verileri net bir şekilde ayırt edebilirsiniz.
Bilekte filtreleme
Bilekte filtreleme, kullanıcının cihazını fiziksel olarak takıp takmadığını belirleme işlemidir. Bu, API'nin gereksiz verileri (ör. cihaz çantadayken araç titreşimleri nedeniyle kaydedilen "hayalet" adımlar) filtrelemesine olanak tanır.
Desteklenen veri türleri
Aşağıdaki veri türleri, gerçek sıfır davranışını ve bilekte filtrelemeyi destekler:
- Rakım
- Mesafe
- Döşeme
- Adımlar
- Toplam Kalori
Uygulamanıza etkisi
Gerçek sıfırların uygulanması, veri boşluğu yorumlamasının ve günlük ortalamalar gibi metrik hesaplamalarının doğruluğunu artırır.
Liste ve toplayıcı davranışı
Google Health API, aşağıdaki veri türleri için varsayılan olarak yalnızca bilekteki verileri döndürür:
- Listeleme işlemleri: Yalnızca cihazın takıldığı dönemlere ait veri noktalarını döndürür. Listedeki boşluklar, cihazın bilekte olmadığını veya senkronize edilmediğini gösterir.
- Toplama işlemleri: Yanıttaki sıfır, gerçek sıfır anlamına gelir (kullanıcı cihazı takıyor ancak hareket etmiyor). Bir takip cihazı belirli bir aralıkta takılmadıysa API, bu toplama penceresi için veri döndürmez.
Fitbit Web API ile karşılaştırma
Fitbit Web API, takip cihazı takılmadığında bile sıfırlar dahil olmak üzere veriler döndürüyordu. Google Health API, hareketin daha doğru bir şekilde gösterilmesini sağlar.
| Özellik | Fitbit Web API | Google Health API |
|---|---|---|
| Etkinlik Olmaması Belirsizliği | Eksik veriler, hareketsizlik veya bilekten çıkarma anlamına gelebilir. | Gerçek sıfırlar, cihaz takılıyken etkinliğin olmadığını açıkça gösterir. |
| Veri Boşlukları | Veri boşlukları, varsayılan olarak UTC saat farklarına ayarlanabilir. | Açık depolama, saat dilimi ve yerel saat sorunlarını çözer. |
| Filtreleme | Bilekte sınırlı filtreleme. | Bilekteki katı filtreleme, fizyolojik doğruluğu sağlar. |