資料存在與否和實際零值

為確保資料準確度及匯總作業一致性，Google 健康資料 API 會採用新式方法回報使用者活動。導入 true zeros 和 on-wrist filtering 後，API 就能準確區分使用者靜止不動的時段，以及未配戴裝置的時段。

True Zeros

「真正為零」是指明確的資料點，表示使用者當時佩戴裝置並主動追蹤，但特定指標的值為零。舉例來說，使用者佩戴裝置時，可能在 1 分鐘間隔內記錄到 0 步或 0 距離。

過去，遺漏資料的意義不明確。這可能表示使用者處於靜態，或是裝置未戴在手腕上。為解決這個問題，API 會在裝置處於穿戴狀態但未啟用時，明確儲存並傳回 0 值。確保你能清楚區分靜止不動的佩戴時間和遺漏的資料。

在手錶上篩選

手環偵測是判斷使用者是否實際配戴裝置的程序。這樣一來，API 就能濾除多餘的資料，例如裝置放在包包中時，因車輛震動而記錄到的「虛假」步數。

支援的資料類型

下列資料類型支援真正的零值行為和手錶上的篩選功能：

• 海拔高度
• 距離
• 樓層數
• 步驟
• 總卡路里

對應用程式的影響

導入實際零值後，資料缺口解讀和指標計算 (例如每日平均值) 的準確度都會提升。

清單和匯總行為

根據預設，Google Health API 只會傳回下列資料類型的手錶資料：

• 列出作業：只會傳回裝置佩戴期間的資料點。
  • 資料缺漏：清單中出現缺漏或遺失的記錄，表示裝置當時未戴在手腕上或未同步。
  • 空白記錄：如果使用者配戴裝置但沒有任何活動 (真正為零)，系統會傳回資料點，並提供正常的 dataSource 和間隔或時間戳記資訊，但會省略指標專屬欄位 (例如 count 屬性)。這些值應解讀為零值。
• 匯總作業：回應中的零表示真正的零 (使用者配戴裝置但未移動)。如果追蹤裝置在特定時間間隔內未配戴，API 就不會傳回該匯總時間範圍的資料。

在 list 作業中，連續同步處理連結裝置也可能會產生重疊間隔，因為裝置端演算法會重新分類原始感應器遙測資料。如要進一步瞭解如何處理間隔重疊問題，請參閱資料管理指南。

與 Fitbit Web API 的比較

即使未配戴追蹤裝置，Fitbit Web API 仍會傳回資料 (包括零)。Google Health API 可更準確地呈現動作。

功能	Fitbit Web API	Google Health API
閒置狀態不明	如果沒有資料，可能表示使用者處於閒置狀態或未配戴手錶。	如果心率為零，表示裝置在配戴期間未偵測到任何活動。
資料缺漏	資料差距可能會預設為世界標準時間偏移量。	明確儲存可解決時區和民用時間問題。
篩選	手錶上的篩選功能有限。	嚴格的手環內建篩選功能可確保生理準確度。