Pour garantir l'exactitude des données et l'homogénéité des agrégations, l'API Google Health modernise la façon dont l'activité des utilisateurs est signalée. En introduisant true zeros et on-wrist filtering, l'API vous permet de faire la distinction entre les périodes où un utilisateur était immobile et celles où il ne portait pas son appareil.
Vrais zéros
Un vrai zéro est un point de données explicite qui indique qu'un utilisateur portait son appareil et effectuait un suivi actif, mais qu'il a enregistré une valeur nulle pour une métrique spécifique. Par exemple, un utilisateur peut enregistrer 0 pas ou 0 distance pendant un intervalle d'une minute alors qu'il porte son appareil.
Historiquement, les données manquantes étaient ambiguës. Cela peut signifier que l'utilisateur était sédentaire ou que l'appareil n'était pas porté au poignet. Pour résoudre ce problème, l'API stocke et renvoie explicitement une valeur 0 lorsque l'appareil est porté, mais inactif. Cela vous permet de distinguer clairement les périodes où le bracelet est immobile au poignet des données manquantes.
Filtrage au poignet
Le filtrage au poignet permet de déterminer si un utilisateur porte physiquement son appareil. L'API peut ainsi filtrer les données superflues, comme les pas "fantômes" enregistrés en raison des vibrations du véhicule lorsqu'un appareil se trouve dans un sac.
Types de données acceptés
Les types de données suivants sont compatibles avec le comportement de zéro absolu et le filtrage sur le bracelet :
- Altitude
- Distance
- Étages
- Étapes
- Total des calories
Impact sur votre application
L'implémentation de vrais zéros améliore la précision de l'interprétation des écarts de données et des calculs de métriques, comme les moyennes quotidiennes.
Comportement des listes et des cumuls
Par défaut, l'API Google Santé ne renvoie que les données enregistrées au poignet pour les types de données suivants :
- Opérations de liste : renvoient des points de données uniquement pour les périodes où l'appareil était porté. Les lacunes dans la liste indiquent que l'appareil n'était pas au poignet ou ne se synchronisait pas.
- Opérations de regroupement : un zéro dans la réponse signifie un vrai zéro (l'utilisateur portait l'appareil, mais ne bougeait pas). Si un appareil de suivi n'a pas été porté pendant un intervalle spécifique, l'API ne renvoie aucune donnée pour cette période.
Comparaison avec l'API Fitbit Web
L'API Web Fitbit renvoyait souvent des données, y compris des zéros, même lorsqu'un appareil de suivi n'était pas porté. L'API Google Santé fournit une représentation plus précise des mouvements.
| Fonctionnalité | API Web Fitbit | API Google Health |
|---|---|---|
| Ambiguïté liée à l'inactivité | Des données manquantes peuvent signifier une inactivité ou que le bracelet n'est pas porté. | Les zéros réels indiquent explicitement l'inactivité lorsque l'appareil est porté. |
| Lacunes dans les données | Les données manquantes peuvent être définies par défaut sur des décalages UTC. | Le stockage explicite résout les problèmes de fuseau horaire et d'heure civile. |
| Filtrage | Filtrage limité sur le bracelet. | Un filtrage strict au niveau du poignet garantit la précision physiologique. |