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 entre los períodos en los que un usuario estuvo quieto y aquellos en los que no usó su dispositivo.
Ceros verdaderos
Un cero verdadero es un punto de datos explícito que indica que un usuario llevaba puesto 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ía indicar que el usuario estuvo sedentario o que el dispositivo no se usó en la muñeca. La API resuelve esto almacenando y devolviendo explícitamente un valor de 0 cuando el dispositivo se usa, pero está inactivo. Esto garantiza que puedas distinguir claramente entre los períodos de inactividad en la muñeca y los datos faltantes.
Filtrado en la muñeca
El filtro en la muñeca es el proceso de identificar si un usuario está usando físicamente su dispositivo. Esto permite que la API filtre los datos externos, 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
- Calorías totales
Impacto en tu aplicación
La implementación de los ceros reales mejora la precisión 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 la acumulación
De forma predeterminada, la API de Google Health solo devuelve datos en la muñeca para los siguientes tipos de datos:
- Operaciones de lista: Devuelven puntos de datos solo para los períodos en los que se usó el dispositivo.
- Brechas de datos: Las brechas y los registros faltantes en la lista indican que el dispositivo no estaba en la muñeca o no se estaba sincronizando.
- Registros vacíos: Los puntos de datos durante los cuales un usuario llevaba puesto el dispositivo, pero no realizó ninguna actividad (un cero real) se muestran con información normal de
dataSourcey de intervalo o marca de tiempo, pero omiten el campo específico de la métrica (como la propiedadcount). Estos valores se deben interpretar como valores cero.
- Operaciones de resumen: Un cero en la respuesta significa un cero real (el usuario llevaba puesto el dispositivo, pero no se movía). Si no se usó un dispositivo de seguimiento durante un intervalo específico, la API no devolverá datos para ese período acumulado.
En las operaciones de list, las sincronizaciones consecutivas de dispositivos conectados también pueden producir intervalos superpuestos cuando los algoritmos integrados en el dispositivo vuelven a agrupar los datos de telemetría sin procesar del sensor. Para obtener más información sobre el manejo de superposiciones de intervalos, consulta la Guía de administración de datos.
Comparación con la API de Fitbit Web
La API de Fitbit Web a menudo devolvía datos, incluidos ceros, incluso cuando no se usaba un dispositivo de monitoreo. La API de Google Health proporciona una representación más precisa del movimiento.
| Función | API web de Fitbit | API de Google Health |
|---|---|---|
| Ambigüedad de inactividad | Los datos faltantes pueden significar inactividad o que el dispositivo no está en la muñeca. | Los ceros reales indican explícitamente la inactividad mientras se usa el dispositivo. |
| Vacíos en los datos | Los intervalos de datos podrían establecerse de forma predeterminada en desfases de UTC. | El almacenamiento explícito resuelve problemas de zona horaria y hora civil. |
| Filtros | Filtrado limitado en la muñeca | El filtrado estricto en la muñeca garantiza la precisión fisiológica. |