為確保資料準確性及一致的彙整結果,Google Health API 採用新式方法回報使用者活動。透過導入 true zeros 和 on-wrist filtering,API 可準確區分使用者靜止不動的時間,以及未配戴裝置的時間。
True Zeros
真正為零是指明確的資料點,表示使用者佩戴裝置並主動追蹤,但特定指標的值為零。舉例來說,使用者佩戴裝置時,可能在 1 分鐘間隔內記錄到 0 步或 0 距離。
過去,遺漏的資料含糊不清。這可能表示使用者處於靜態,或是裝置未戴在手腕上。為解決這個問題,API 會在裝置處於穿戴狀態但未啟用時,明確儲存並傳回 0 值。確保你能清楚區分裝置靜止不動的佩戴時間和遺漏的資料。
在手錶上篩選
手環偵測是判斷使用者是否實際配戴裝置的程序。這樣一來,API 就能濾除多餘的資料,例如裝置放在包包中時,因車輛震動而記錄到的「虛假」步數。
支援的資料類型
下列資料類型支援真正的零值行為和手錶上的篩選功能:
- 海拔高度
- 距離
- 樓層數
- 步驟
- 總卡路里
對應用程式的影響
導入實際零值後,資料缺口解讀和指標計算 (例如每日平均值) 的準確度都會提升。
清單和匯總行為
根據預設,Google Health API 只會傳回下列資料類型的手錶資料:
- 列出作業:只會傳回裝置穿戴期間的資料點。清單中的空白處表示裝置未戴在手腕上,或未同步處理。
- 匯總作業:如果回應中的值為零,表示實際為零 (使用者配戴裝置但未移動)。如果使用者在特定時間間隔內未配戴追蹤裝置,API 就不會傳回該匯總視窗的資料。
與 Fitbit Web API 比較
即使未配戴追蹤裝置,Fitbit Web API 通常也會傳回資料 (包括零)。Google Health API 則能更準確地呈現活動資料。
| 功能 | Fitbit Web API | Google Health API |
|---|---|---|
| 閒置狀態不明 | 如果沒有資料,可能表示使用者處於閒置狀態或未配戴手錶。 | 如果顯示為零,表示裝置在穿戴期間未偵測到任何活動。 |
| 資料缺漏 | 資料間隔可能會預設為世界標準時間偏移量。 | 明確儲存可解決時區和民用時間問題。 |
| 篩選 | 手錶上的篩選功能有限。 | 嚴格的手環內建篩選功能可確保生理準確度。 |