Para garantir a precisão dos dados e agregações consistentes, a API Google Health moderniza a forma como a atividade do usuário é informada. Ao introduzir true zeros e on-wrist filtering, a API permite distinguir com precisão entre períodos em que um usuário estava parado e quando não estava usando o dispositivo.
Zeros reais
Um zero verdadeiro é um ponto de dados explícito que indica que um usuário estava usando o dispositivo e monitorando ativamente, mas registrou um valor zero para uma métrica específica. Por exemplo, um usuário pode registrar 0 etapas ou 0 distância durante um intervalo de 1 minuto enquanto usa o dispositivo.
Historicamente, os dados ausentes eram ambíguos. Isso pode significar que o usuário estava sedentário ou que o dispositivo não estava no pulso. A API resolve isso armazenando e retornando explicitamente um valor 0 quando o dispositivo está sendo usado, mas está inativo. Isso garante que você possa distinguir claramente entre períodos estacionários no pulso e dados ausentes.
Filtragem no pulso
A filtragem no pulso é o processo de identificar se um usuário está usando o dispositivo. Isso permite que a API filtre dados estranhos, como etapas "fantasmas" registradas devido a vibrações do veículo enquanto um dispositivo está em uma bolsa.
Tipos de dados compatíveis
Os seguintes tipos de dados são compatíveis com o comportamento de zero verdadeiro e a filtragem no pulso:
- Altitude
- Distância
- Andares
- Etapas
- Total de calorias
Impacto no seu aplicativo
A implementação de zeros reais melhora a precisão da interpretação de lacunas de dados e dos cálculos de métricas, como médias diárias.
Comportamento de lista e rollup
Por padrão, a API Google Health retorna apenas dados do pulso para os seguintes tipos de dados:
- Operações de lista:retornam pontos de dados apenas para períodos em que o dispositivo foi usado. Lacunas na lista indicam que o dispositivo estava fora do pulso ou não estava sincronizando.
- Operações de rollup:um zero na resposta significa um zero verdadeiro (o usuário estava usando o dispositivo, mas não se moveu). Se um dispositivo de rastreamento não foi usado durante um intervalo específico, a API não retorna dados para essa janela de rollup.
Comparação com a API Fitbit Web
A API Fitbit Web costumava retornar dados, incluindo zeros, mesmo quando um dispositivo de rastreamento não estava sendo usado. A API Google Health oferece uma representação mais precisa do movimento.
| Recurso | API Fitbit Web | API Google Health |
|---|---|---|
| Ambiguidade de inatividade | Dados ausentes podem significar inatividade ou que o dispositivo não está no pulso. | Os zeros verdadeiros indicam explicitamente a inatividade durante o uso. |
| Lacunas de dados | As lacunas de dados podem usar offsets de UTC por padrão. | O armazenamento explícito resolve problemas de fuso horário e hora civil. |
| Filtro | Filtragem limitada no pulso. | A filtragem rigorosa no pulso garante a precisão fisiológica. |