Tipos de dados da API Google Health

A tabela a seguir contém a lista completa de tipos de dados, com várias colunas para ajudar você a entender a representação de cada tipo na API Google Health, bem como o escopo em que cada um está disponível.

Importante:o formato dos identificadores de tipo de dados muda quando o tipo de dados tem mais de uma palavra. Em um endpoint, o nome do tipo de dados precisa estar em kebab case, como body-fat. Em um parâmetro de filtro, no entanto, o nome do tipo de dados precisa estar em snake case, como body_fat.

Tabela: tipos de dados da API Google Health

Tipo de dado   dataType Parâmetro   filter	Record type	Operações disponíveis	Escopo	Suporte a webhook	Suporte a zeros reais
Gasto de energia ativa   active-energy-burned   active_energy_burned	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Minutos ativos   active-minutes   active_minutes	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Minutos na faixa ativa   active-zone-minutes   active_zone_minutes	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Nível de atividade   activity-level   activity_level	Intervalo	list, reconcile	activity_and_fitness
Altitude   altitude   altitude	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Glicose no sangue   blood-glucose   blood_glucose	Exemplo	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Gordura corporal   body-fat   body_fat	Exemplo	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements
Calorias na zona de frequência cardíaca   calories-in-heart-rate-zone   calories_in_heart_rate_zone	Intervalo	rollup, dailyRollup	activity_and_fitness
Temperatura corporal central   core-body-temperature   core_body_temperature	Exemplo	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Variabilidade da frequência cardíaca diária   daily-heart-rate-variability   daily_heart_rate_variability	Diário	list, reconcile	health_metrics_and_measurements
Zonas de frequência cardíaca diárias   daily-heart-rate-zones   daily_heart_rate_zones	Diário	list, reconcile	health_metrics_and_measurements
Saturação de oxigênio diária   daily-oxygen-saturation   daily_oxygen_saturation	Diário	list, reconcile	health_metrics_and_measurements
Frequência respiratória diária   daily-respiratory-rate   daily_respiratory_rate	Diário	list, reconcile	health_metrics_and_measurements
Frequência cardíaca em repouso diária   daily-resting-heart-rate   daily_resting_heart_rate	Diário	list, reconcile	health_metrics_and_measurements
Derivações diárias da temperatura do sono   daily-sleep-temperature-derivations   daily_sleep_temperature_derivations	Diário	list, reconcile	health_metrics_and_measurements
VO₂ máx. diário   daily-vo2-max   daily_vo2_max	Diário	list, reconcile	activity_and_fitness
Distância   distance   distance	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Eletrocardiograma (ECG)   electrocardiogram   electrocardiogram	Sessão	list	ecg
Exercício   exercise   exercise	Sessão	list, get, reconcile, create, update, batchDelete	activity_and_fitness
Pisos   floors   floors	Intervalo	reconcile, rollup, dailyRollup	activity_and_fitness
Comida   food   food	Comida	list, get	nutrition
Unidade de medida de alimentos   food-measurement-unit   food_measurement_unit	Comida	list, get	nutrition
Frequência cardíaca   heart-rate   heart_rate	Exemplo	list, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Variabilidade da frequência cardíaca   heart-rate-variability   heart_rate_variability	Exemplo	list, reconcile	health_metrics_and_measurements
Altura   height   height	Exemplo	list, get, reconcile, create, update, batchDelete	health_metrics_and_measurements
Registro de hidratação   hydration-log   hydration_log	Sessão	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	nutrition
Notificação de ritmo irregular   irregular-rhythm-notification   irregular_rhythm_notification	Sessão	list	irn
Registro de alimentação   nutrition-log   nutrition_log	Exemplo	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	nutrition
Saturação de oxigênio   oxygen-saturation   oxygen_saturation	Exemplo	list, reconcile	health_metrics_and_measurements
Resumo do sono com ritmo respiratório   respiratory-rate-sleep-summary   respiratory_rate_sleep_summary	Exemplo	list, reconcile	health_metrics_and_measurements
VO₂ máx. da corrida   run-vo2-max   run_vo2_max	Exemplo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Período sedentário   sedentary-period   sedentary_period	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Para dormir   sleep   sleep	Sessão	list, get, reconcile, create, update, batchDelete	dormir
Etapas   steps   steps	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Dados de voltas de natação   swim-lengths-data   swim_lengths_data	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Tempo na zona de frequência cardíaca   time-in-heart-rate-zone   time_in_heart_rate_zone	Intervalo	list, reconcile, rollup, dailyRollup	activity_and_fitness
Total de calorias   total-calories   total_calories	Intervalo	rollup, dailyRollup	activity_and_fitness
VO₂ máx.   vo2-max   vo2_max	Exemplo	list, reconcile	activity_and_fitness
Peso   weight   weight	Exemplo	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements

Restrições de consulta

Ao consultar pontos de dados, resumos ou resumos diários da API, considere as seguintes restrições:

• Requisitos de filtro:alguns tipos de dados derivados somente leitura, como total-calories, exigem um filtro que especifique um horário de início de intervalo (usando tempo físico ou civil).
• Limites do período da consulta:o período máximo da consulta para calories-in-heart-rate-zone, heart-rate, active-minutes e total-calories é de 14 dias. O período máximo de consulta para todos os outros tipos de dados é de 90 dias.

Disponibilidade de dados

As atualizações dos dados do usuário só ficam disponíveis depois que ele sincroniza o tracker de atividades ou insere manualmente novos dados no app Fitbit para dispositivos móveis ou na Web. O dispositivo Fitbit e o app Fitbit para dispositivos móveis podem ser sincronizados automaticamente a cada 15 minutos quando o app Fitbit está aberto no dispositivo móvel e os dois têm uma conexão de dados ativa e estão dentro do alcance do Bluetooth. Se o usuário estiver monitorando a atividade com o MobileTrack, ele será sincronizado a cada hora enquanto o app estiver aberto.

Consultar dados históricos

Um dos principais benefícios da API Google Health é a capacidade de acompanhar o desempenho de um usuário e monitorar os sinais vitais dele por longos períodos. Você pode consultar os dados de um usuário desde que eles foram registrados. A API não impõe limitações ou restrições à quantidade de dados históricos que seu aplicativo pode consumir.

No entanto, a consulta de dados históricos ainda é regida pelos limites de taxa padrão. Para reduzir o número de chamadas de API em relação a esses limites, a API Google Health permite consultar dados em um período. Observe os seguintes limites de paginação e solicitação:

• Cada endpoint retorna um tamanho máximo de página de 10.000 pontos de dados por página.
• Os períodos de datas de consulta são restritos a 14 e 90 dias por solicitação.

Dependendo do volume de dados históricos que seu aplicativo precisa, a recuperação do conjunto de dados completo pode exigir várias solicitações sequenciais e levar mais tempo. Tenha isso em mente ao projetar o processo de sincronização de dados do aplicativo.

Acesso de terceiros

Os dispositivos Fitbit não podem se comunicar diretamente com aplicativos ou serviços de terceiros. Esses dispositivos foram criados para se comunicar e sincronizar exclusivamente com o app Fitbit para dispositivos móveis.

O dispositivo sincroniza dados automaticamente ao longo do dia, sempre que o app Fitbit está aberto ou a cada 15 minutos se o Bluetooth estiver ativo e o app estiver em execução em segundo plano. Depois que esse processo de sincronização é concluído, os dados ficam disponíveis para serviços de terceiros pela API Google Health.

Padrões de distância

As distâncias de exercícios, como elevationGainMillimeters, são medidas em milímetros como unidade padrão pelos seguintes motivos:

1. Manter a precisão dos dados: o motivo mais importante para usar milímetros é garantir que não vamos perder a precisão dos dados que lemos e fornecemos. Usar uma unidade refinada como milímetros permite representar medições com alta precisão.
2. Padronização: milímetros são a unidade padrão projetada em todos os nossos serviços. Essa consistência ajuda a garantir uma experiência uniforme para desenvolvedores que interagem com diferentes partes da API.
3. Suporte amplo a sistemas de medição: usar uma unidade básica, como milímetros, facilita a conversão para qualquer outra unidade escolhida, seja métrica, imperial ou outros sistemas de medição.

Duração variável do dia

O processamento de tempo pela API Health prioriza o tempo do usuário para considerar a duração variável dos dias causada pelo horário de verão ou por viagens. Cada ponto de dados é armazenado com um carimbo de data/hora UTC físico e o ajuste UTC ativo no momento do evento. Isso permite que o sistema:

• Mapeie o evento para um instante físico preciso.
• Corrija o horário para o contexto local do usuário para agregação.

Horário de verão

Quando o horário de verão acontece, um "recuo" resulta em um dia civil de 25 horas, e o resumo dessa data contém 25 horas de dados. Um "avanço" resulta em um dia civil de 23 horas em que o horário volta para o horário padrão.

Viagem

Viajar por fusos horários pode causar variações ainda mais significativas na duração física de um único dia civil.

Use o endpoint dailyRollUp para conciliar diferenças de fuso horário. Ele atribui automaticamente os dados ao dia do calendário em que foram registrados, de acordo com a hora local do usuário, "unindo" o dia, apesar das mudanças de fuso horário.