数据存在情况和真实零值

为了确保数据准确性和一致的汇总,Google Health API 对用户活动报告方式进行了现代化改造。通过引入 true zeroson-wrist filtering,该 API 可让您准确区分用户处于静止状态的时间段与用户未佩戴设备的时间段。

True Zeros

True Zero 是一个明确的数据点,表示用户佩戴了设备并主动进行跟踪,但特定指标记录的值为零。例如,用户在佩戴设备期间的 1 分钟间隔内可能记录了 0 步或 0 距离。

过去,缺少数据的情况比较模糊。这可能表示用户处于久坐状态,也可能表示设备未佩戴在手腕上。该 API 通过在设备佩戴但处于非活跃状态时明确存储和返回 0 值来解决此问题。这样可确保您能够清楚地区分佩戴在手腕上且处于静止状态的时间段与缺少数据的情况。

On-wrist filtering

On-wrist filtering 是指识别用户是否实际佩戴了设备的过程。这样,API 就可以滤除无关数据,例如设备放在包中时因车辆振动而记录的“幻影”步数。

支持的数据类型

以下数据类型支持 True Zero 行为和 On-wrist filtering:

  • 海拔高度
  • 距离
  • 楼层数
  • 步数
  • 总卡路里数

对应用的影响

True Zero 的实现提高了数据缺口解读和指标计算(例如每日平均值)的准确性。

列表和汇总行为

默认情况下,Google Health API 仅针对以下数据类型返回佩戴在手腕上的数据

  • 列表操作: 仅针对设备佩戴期间返回数据点。列表中的缺口表示设备未佩戴在手腕上或未同步。
  • 汇总操作: 响应中的零表示 True Zero (用户佩戴了设备但未移动)。如果跟踪设备在特定时间间隔内未佩戴,则 API 不会返回该汇总窗口的任何数据。

与 Fitbit Web API 的比较

即使跟踪设备未佩戴,Fitbit Web API 通常也会返回数据(包括零)。Google Health API 可以更准确地表示运动情况。

功能 Fitbit Web API Google Health API
非活跃状态的模糊性 缺少数据可能表示处于非活跃状态或未佩戴在手腕上。 True Zero 明确表示佩戴时处于非活跃状态。
数据缺口 数据缺口可能会默认为 UTC 偏移量。 明确存储可解决时区和民用时间问题。
过滤 On-wrist filtering 功能有限。 严格的 On-wrist filtering 可确保生理准确性。