Per garantire l'accuratezza dei dati e aggregazioni coerenti, l'API Google Health modernizza la modalità di segnalazione dell'attività dell'utente. Grazie all'introduzione di true zeros e on-wrist filtering, l'API ti consente di distinguere con precisione i periodi in cui un utente era fermo da quelli in cui non indossava il dispositivo.
True Zeros
Un true zero è un punto dati esplicito che indica che un utente indossava il dispositivo e monitorava attivamente, ma ha registrato un valore pari a zero per una metrica specifica. Ad esempio, un utente potrebbe registrare 0 passi o 0 distanza durante un intervallo di 1 minuto mentre indossa il dispositivo.
Storicamente, i dati mancanti erano ambigui. Potrebbero indicare che l'utente era sedentario o che il dispositivo non era al polso. L'API risolve questo problema memorizzando e restituendo esplicitamente un valore pari a 0 quando il dispositivo è indossato ma inattivo. In questo modo, puoi distinguere chiaramente tra i periodi in cui il dispositivo è indossato e fermo e i dati mancanti.
On-wrist filtering
Il on-wrist filtering è il processo di identificazione se un utente indossa fisicamente il dispositivo. In questo modo, l'API può filtrare i dati estranei, ad esempio i passi "fantasma" registrati a causa delle vibrazioni del veicolo mentre un dispositivo è in una borsa.
Tipi di dati supportati
I seguenti tipi di dati supportano il comportamento true zero e il on-wrist filtering:
- Altitudine
- Distanza
- Piani
- Passaggi
- Calorie totali
Impatto sulla tua applicazione
L'implementazione di true zeros migliora l'accuratezza dell'interpretazione dei gap di dati e dei calcoli delle metriche, come le medie giornaliere.
Comportamento di elenco e rollup
Per impostazione predefinita, l'API Google Health restituisce solo i dati on-wrist per i seguenti tipi di dati:
- Operazioni di elenco: restituisce i punti dati solo per i periodi in cui il dispositivo è stato indossato. I gap nell'elenco indicano che il dispositivo non era al polso o non era in sincronizzazione.
- Operazioni di rollup: uno zero nella risposta indica un true zero (l'utente indossava il dispositivo ma non si muoveva). Se un dispositivo di monitoraggio non è stato indossato durante un intervallo specifico, l'API non restituisce dati per la finestra di rollup.
Confronto con l'API web Fitbit
L'API Fitbit Web spesso restituiva dati, inclusi gli zeri, anche quando un dispositivo di monitoraggio non veniva indossato. L'API Google Health fornisce una rappresentazione più accurata del movimento.
| Funzionalità | API web Fitbit | API Google Health |
|---|---|---|
| Ambiguità di inattività | I dati mancanti potrebbero indicare inattività o che il dispositivo non era al polso. | I true zeros indicano esplicitamente l'inattività mentre il dispositivo è indossato. |
| Gap di dati | I gap di dati potrebbero essere impostati per impostazione predefinita sugli offset UTC. | La memorizzazione esplicita risolve i problemi relativi al fuso orario e all'ora civile. |
| Filtro | Filtro on-wrist limitato. | Il filtro on-wrist rigoroso garantisce l'accuratezza fisiologica. |