資料存在與否和實際零值

為確保資料準確性及一致的彙整結果,Google Health API 採用新式方法回報使用者活動。透過導入 true zeroson-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
閒置狀態不明 如果沒有資料,可能表示使用者處於閒置狀態或未配戴手錶。 如果顯示為零,表示裝置在穿戴期間未偵測到任何活動。
資料缺漏 資料間隔可能會預設為世界標準時間偏移量。 明確儲存可解決時區和民用時間問題。
篩選 手錶上的篩選功能有限。 嚴格的手環內建篩選功能可確保生理準確度。