Para garantizar la precisión de los datos y las agregaciones coherentes, la API de Google Health moderniza la forma en que se informa la actividad del usuario. Con la introducción de true zeros y on-wrist filtering, la API te permite distinguir con precisión los períodos en los que un usuario estaba inmóvil de aquellos en los que no usaba su dispositivo.
Ceros verdaderos
Un cero verdadero es un punto de datos explícito que indica que un usuario usaba su dispositivo y realizaba un seguimiento activo, pero registró un valor de cero para una métrica específica. Por ejemplo, un usuario puede registrar 0 pasos o 0 distancia durante un intervalo de 1 minuto mientras usa su dispositivo.
Históricamente, los datos faltantes eran ambiguos. Podrían significar que el usuario era sedentario o que el dispositivo no estaba en la muñeca. La API resuelve esto almacenando y mostrando explícitamente un valor de 0 cuando el dispositivo se usa, pero está inactivo. Esto garantiza que puedas distinguir claramente entre los períodos inmóviles en la muñeca y los datos faltantes.
Filtrado en la muñeca
El filtrado en la muñeca es el proceso de identificar si un usuario usa físicamente su dispositivo. Esto permite que la API filtre datos extraños, como los pasos "fantasma" registrados debido a las vibraciones del vehículo mientras un dispositivo está en una bolsa.
Tipos de datos admitidos
Los siguientes tipos de datos admiten el comportamiento de cero verdadero y el filtrado en la muñeca:
- Altitud
- Distancia
- Pisos
- Pasos
- Total de calorías
Impacto en tu aplicación
La implementación de ceros verdaderos mejora la exactitud de la interpretación de las brechas de datos y los cálculos de métricas, como los promedios diarios.
Comportamiento de la lista y el resumen
De forma predeterminada, la API de Google Health muestra solo datos en la muñeca para los siguientes tipos de datos:
- Operaciones de lista: Muestra puntos de datos solo para los períodos en los que se usó el dispositivo. Las brechas en la lista indican que el dispositivo no estaba en la muñeca o no se estaba sincronizando.
- Operaciones de resumen: Un cero en la respuesta significa un cero verdadero (el usuario usaba el dispositivo, pero no se movía). Si no se usó un dispositivo de seguimiento durante un intervalo específico, la API no muestra datos para esa ventana de resumen.
Comparación con la API de Fitbit Web
La API de Fitbit Web solía mostrar datos, incluidos ceros, incluso cuando no se usaba un dispositivo de seguimiento. La API de Google Health proporciona una representación más precisa del movimiento.
| Función | API de Fitbit Web | API de Google Health |
|---|---|---|
| Ambigüedad de inactividad | Los datos faltantes podrían significar inactividad o que el dispositivo no estaba en la muñeca. | Los ceros verdaderos indican explícitamente la inactividad mientras se usan. |
| Brechas de datos | Las brechas de datos podrían establecerse de forma predeterminada en compensaciones de UTC. | El almacenamiento explícito resuelve los problemas de zona horaria y hora civil. |
| Filtrado | Filtrado limitado en la muñeca. | El filtrado estricto en la muñeca garantiza la precisión fisiológica. |