Presenza di dati e zeri effettivi

Per garantire l'accuratezza dei dati e aggregazioni coerenti, l'API Google Health modernizza il modo in cui viene segnalata l'attività utente. Con l'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

Uno zero effettivo è un punto dati esplicito che indica che un utente indossava il dispositivo e lo 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. Potrebbe significare che l'utente era sedentario o che il dispositivo non era indossato. L'API risolve questo problema memorizzando e restituendo esplicitamente un valore 0 quando il dispositivo è indossato ma inattivo. In questo modo puoi distinguere chiaramente tra i periodi di stazionamento al polso e i dati mancanti.

Filtro su polso

Il filtraggio al polso è il processo di identificazione che determina se un utente indossa fisicamente il dispositivo. Ciò consente all'API di filtrare i dati estranei, ad esempio i passi "fantasma" registrati a causa delle vibrazioni del veicolo mentre un dispositivo si trova in una borsa.

Tipi di dati supportati

I seguenti tipi di dati supportano il comportamento di zero effettivo e il filtraggio sul polso:

• Altitudine
• Distanza
• Piani
• Passaggi
• Calorie totali

Impatto sulla tua applicazione

L'implementazione di zeri effettivi migliora l'accuratezza dell'interpretazione delle lacune nei dati e dei calcoli delle metriche, ad esempio le medie giornaliere.

Comportamento di elenchi e rollup

Per impostazione predefinita, l'API Google Health restituisce solo i dati sul polso per i seguenti tipi di dati:

• Operazioni di elenco:restituisce punti dati solo per i periodi in cui il dispositivo è stato indossato.
  • Lacune nei dati:le lacune e i record mancanti nell'elenco indicano che il dispositivo non era indossato o non era in sincronizzazione.
  • Record vuoti:i punti dati durante i quali un utente indossava il dispositivo ma non ha svolto alcuna attività (un vero zero) vengono restituiti con le normali informazioni su dataSource e intervallo o timestamp, ma omettono il campo specifico della metrica (ad esempio la proprietà count). Questi valori devono essere interpretati come valori pari a zero.
• Operazioni di rollup:uno zero nella risposta indica uno zero effettivo (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 quel periodo di aggregazione.

Nelle operazioni list, le sincronizzazioni consecutive dei dispositivi connessi possono anche produrre intervalli sovrapposti quando gli algoritmi sul dispositivo raggruppano nuovamente la telemetria dei sensori non elaborata. Per saperne di più sulla gestione delle sovrapposizioni degli intervalli, consulta la guida alla gestione dei dati.

Confronto con l'API Fitbit Web

L'API Fitbit Web restituiva spesso 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 Fitbit Web	API Google Health
Ambiguità dell'inattività	La mancanza di dati potrebbe indicare inattività o che il dispositivo non è indossato.	Gli zeri effettivi indicano esplicitamente l'inattività durante l'utilizzo.
Lacune nei dati	I gap nei dati potrebbero essere impostati come offset UTC per impostazione predefinita.	L'archiviazione esplicita risolve i problemi relativi al fuso orario e all'ora civile.
Filtri	Filtro limitato sul polso.	Il filtraggio rigoroso sul polso garantisce l'accuratezza fisiologica.