Quais tipos de dados do Apple Health o Life Dashboard envia?

O app do iPhone lê 28 tipos do Apple Health (o app Saúde do iPhone), e cada um fica desativado até você ativá-lo em O que enviar, por categoria ou com Essenciais ou Todos os tipos. Ele os envia com as chaves do payload do app para Android, com os mesmos campos e unidades: passos, distância e calorias, treinos, peso e composição corporal, frequência cardíaca, frequência cardíaca em repouso e VFC, pressão arterial, glicose, oxigênio no sangue, frequência respiratória, VO2 máx., sono com fases, água, nutrição, mindfulness, temperatura corporal e monitoramento do ciclo. A menstruação sai como duas chaves, então um iPhone envia 29 das 34 chaves do app para Android.

Todo registro traz um uuid, o da própria amostra do Apple Health, e um source: o nome que o Apple Health dá ao app ou aparelho que o gravou. O app só lê; ele nunca grava no Apple Health.

Por Owen Vogelaar, que mantém o Life Dashboard 10 min de leitura

Baixar o app para iPhone

Todos os tipos em um relance

A coluna Apple Watch diz onde a documentação da Apple descreve o relógio registrando o tipo; Apple Watch no Home Assistant tem o link de cada página. Os outros tipos vêm do iPhone, do que você mesmo registra ou de apps que gravam no Apple Health.

TipoChave do payloadValor e unidadeHome AssistantApple Watch
PassosstepscountTotal de hojeSim, e o iPhone
DistânciadistancemetersTotal de hojeSim, e o iPhone
Energia Ativaactive_caloriescalories, kcalTotal de hojeSim
Energia Totaltotal_caloriescalories, kcalTotal de hojeSim
Treinosexercisetype, duration_secondsÚltimo treino, minutos de hoje e de ontemSim
PesoweightkilogramsValor mais recenteNão
AlturaheightmetersValor mais recenteNão
Percentual de Gordura Corporalbody_fatpercentageValor mais recenteNão
Massa Corporal Magralean_body_masskilogramsValor mais recenteNão
Frequência Cardíacaheart_ratebpmValor mais recenteSim
Frequência Cardíaca em Repousoresting_heart_ratebpmValor mais recenteSim
Variabilidade da Frequência Cardíacaheart_rate_variabilityheart_rate_variability_millis, ms (SDNN)Valor mais recenteSim
Pressão Arterialblood_pressuresystolic, diastolic, mmHgDois sensoresNão
Oxigênio no Sangueoxygen_saturationpercentageValor mais recenteAlguns modelos e regiões
Frequência Respiratóriarespiratory_raterate, respirações por minutoValor mais recenteSim, durante o sono
Temperatura Corporalbody_temperaturecelsiusValor mais recenteNão
Temperatura Corporal Basalbasal_body_temperaturecelsiusValor mais recenteNão
Glicose no Sangueblood_glucosemmol_per_literValor mais recenteNão
VO2 máx.vo2_maxvo2_ml_per_min_per_kgValor mais recenteSim, durante alguns treinos
Sonosleepduration_seconds, stagesDuração do último sono, tempo dormindo e horas por faseSim, com fases
Mindfulnessmindfulnessduration_secondsMinutos por dia, nas estatísticasDesconhecido
ÁguahydrationlitersÚltima bebidaNão
Nutriçãonutritioncalories, gramas e mais 34 nutrientesCalorias, proteínas, carboidratos e gorduras consumidos hojeNão
Menstruaçãomenstruation_flow, menstruation_periodflow; start_time, end_timeSem sensorNão
Sangramento Intermenstrualintermenstrual_bleedingSó o horárioSem sensorNão
Resultado do Teste de Ovulaçãoovulation_testresultSem sensorNão
Qualidade do Muco Cervicalcervical_mucusappearance, sensationSem sensorNão
Atividade Sexualsexual_activityprotection_usedSem sensorNão

"Não" e "Desconhecido" na coluna Apple Watch querem dizer que a documentação da Apple sobre o relógio, como citada neste site, não descreve o relógio registrando o tipo, não que nada consiga registrar. Para ver o que grava um tipo no seu iPhone, abra o app Saúde, encontre o tipo e olhe em Fontes de Dados e Acesso.

Qual fonte grava qual tipo

  • Apple Watch: passos, distância, energia ativa e em repouso, treinos, frequência cardíaca, frequência cardíaca em repouso, VFC, sono com fases, frequência respiratória durante o sono, VO2 máx. durante alguns treinos ao ar livre, e oxigênio no sangue nos modelos e nas regiões que têm o recurso. Apple Watch no Home Assistant traz os detalhes e as páginas da Apple.
  • iPhone: passos e distância. Um iPhone sem relógio normalmente não registra energia em repouso, então total_calories vem quase sempre com um relógio.
  • Outros apps e aparelhos: os apps de outros relógios, anéis e balanças, como o Garmin Connect, o Oura e o Withings, podem gravar no Apple Health, assim como os apps em que você registra comida, água, monitoramento do ciclo ou meditação. O que eles gravam depende do app e das suas configurações nele; cada registro informa o app em source.

O Apple Health guarda duas vezes uma caminhada que o iPhone e o relógio registraram, uma por aparelho. Os daily_totals de cada payload contam essa caminhada uma vez só, na ordem das fontes de dados que você definiu no app Saúde, então use esses valores para os totais diários.

Atividade

Passos

Chave steps: count, um número inteiro, em um intervalo de start_time a end_time. Até 1000 registros novos por sincronização.

Distância

Chave distance: meters, em um intervalo. O Apple Health tem um tipo de distância para cada modalidade de atividade, e o app lê todos: caminhada e corrida, ciclismo, natação, cadeira de rodas, esportes de neve em descida e, a partir do iOS 18, remo, canoagem, esqui cross-country e patinação. Eles não se sobrepõem, então somar todos não conta nada em dobro. Um registro não diz de qual atividade veio.

Energia Ativa

Chave active_calories: calories em kcal, em um intervalo. É a energia ativa do Apple Health.

Energia Total

Chave total_calories: calories em kcal, em um intervalo. O Apple Health não tem um tipo de energia total, então são os registros de energia em repouso e de energia ativa juntos. Por isso, uma mesma amostra de energia ativa faz parte de active_calories e de total_calories. Até 1000 registros novos por sincronização. Em daily_totals, só é enviada nos dias com energia em repouso.

Treinos

Chave exercise: type, start_time, end_time e duration_seconds, a partir dos treinos do Apple Health. type é a atividade em snake_case, como running, walking, downhill_skiing ou hiit; other é o Outro da própria Apple, ou uma atividade de um iOS mais novo que o app. duration_seconds inclui as pausas, então pode ser maior que o tempo de treino que o app Saúde mostra. Aqui o Android envia um número como string, como "56" para corrida.

Corpo

Peso

Chave weight: kilograms, em um momento (time), com até 2 casas decimais, para que um peso informado em libras sobreviva à conversão.

Altura

Chave height: meters, em um momento.

Percentual de Gordura Corporal

Chave body_fat: percentage, de 0 a 100, em um momento.

Massa Corporal Magra

Chave lean_body_mass: kilograms, em um momento.

Coração e sinais vitais

Frequência Cardíaca

Chave heart_rate: bpm, um número inteiro, em um momento, um registro por amostra. Até 1000 registros novos por sincronização. Cada amostra tem o seu próprio uuid; o formato <uuid>#<time> do Android não se aplica.

Frequência Cardíaca em Repouso

Chave resting_heart_rate: bpm, um número inteiro, em um momento.

Variabilidade da Frequência Cardíaca

Chave heart_rate_variability: heart_rate_variability_millis, em um momento. É SDNN, a medida que o Apple Health guarda. O Android envia RMSSD, a que o Conexão Saúde (Health Connect) guarda, na mesma chave; as duas não são o mesmo número, então mantenha as duas separadas. Até 500 registros novos por sincronização.

Pressão Arterial

Chave blood_pressure: systolic e diastolic em mmHg, em um momento, por medição: os dois valores que um app salvou juntos. O raro app que os salva separados tem os dois reunidos quando chegam com até um segundo de diferença. Um valor sem a sua outra metade não é enviado. O uuid é o da amostra sistólica.

Temperatura Corporal

Chave body_temperature: celsius, em um momento.

Temperatura Corporal Basal

Chave basal_body_temperature: celsius, em um momento.

Glicose no Sangue

Chave blood_glucose: mmol_per_liter, em um momento.

Oxigênio no Sangue

Chave oxygen_saturation: percentage, de 0 a 100, em um momento.

Frequência Respiratória

Chave respiratory_rate: rate em respirações por minuto, em um momento. Até 500 registros novos por sincronização.

VO2 máx

Chave vo2_max: vo2_ml_per_min_per_kg, em um momento.

Sono e mente

Sono

Chave sleep: session_end_time, duration_seconds e stages, cada fase com o seu próprio stage, horários, uuid e source. O Apple Health não tem sessão de sono, então o app agrupa as amostras de fases em noites, e um intervalo de mais de uma hora começa uma nova.

  • Fases: light (a Essencial, ou Core, da Apple), deep, rem, awake, sleeping e unknown, que o Android também envia, e in_bed, que só um iPhone envia: o tempo na cama em volta das fases, que não é uma fase.
  • O uuid de uma noite vem da fase mais antiga dela, então continua o mesmo enquanto a noite cresce. Substitua a noite quando ela voltar mais longa. Uma fase adicionada depois faz a noite inteira ser enviada de novo.
  • O source da noite é o app ou aparelho que registrou a maior parte das fases dela.

Mindfulness

Chave mindfulness: start_time, end_time e duration_seconds, de apps que gravam sessões de atenção plena no Apple Health. Sem title, que o Android pode enviar.

Comida e bebida

Água

Chave hydration: liters, em um intervalo. É a água do Apple Health.

Nutrição

Chave nutrition: calories, protein_grams, carbs_grams, fat_grams, name e mais 34 nutrientes com as chaves do Android, como dietary_fibre_g, sugars_g, sodium_mg e caffeine_mg, em um intervalo. Todos os campos são opcionais.

  • Um alimento que um app registrou, com todos os nutrientes dele, é um registro só, com o nome quando o app informou um.
  • Os outros 34 nutrientes só são lidos de um alimento que também tenha energia, proteínas, carboidratos ou gorduras, então um café registrado só com cafeína não é enviado.
  • O Apple Health não tem tipo para gordura trans, gordura insaturada, energia vinda da gordura, ácido fólico nem meal_type, então esses nunca vêm de um iPhone.

Monitoramento do ciclo

Menstruação

Um botão, duas chaves. menstruation_flow tem flow em um momento, com os valores do esquema compartilhado: light, medium, heavy ou unknown. menstruation_period tem só start_time e end_time: o Apple Health não tem um registro de período menstrual, então o app deduz os períodos a partir de dias consecutivos de fluxo, e um intervalo de até 48 horas cobre um dia que faltou. O uuid de um período vem do primeiro dia de fluxo, então substitua o período quando ele voltar mais longo.

Sangramento Intermenstrual

Chave intermenstrual_bleeding: só o time.

Resultado do Teste de Ovulação

Chave ovulation_test: result em um momento: positive (pico de LH), high (pico de estrogênio), negative, inconclusive ou unknown.

Qualidade do Muco Cervical

Chave cervical_mucus: appearance e sensation em um momento. O Apple Health não registra a sensação, então sensation é sempre unknown.

Atividade Sexual

Chave sexual_activity: protection_used em um momento: protected ou unprotected quando o app que gravou registrou isso, unknown caso contrário.

Por MQTT, os registros do monitoramento do ciclo não são publicados, porque um tópico retido não é lugar para dados reprodutivos; a temperatura corporal basal é publicada. A integração do Home Assistant e um webhook recebem todos.

As cinco chaves do Android que um iPhone nunca envia

Chave do AndroidPor que não
speedO app do iPhone ainda não lê a velocidade.
bone_massO Apple Health não tem um tipo de massa óssea.
body_water_massO Apple Health não tem um tipo de água corporal.
skin_temperatureO Apple Health guarda a temperatura absoluta do pulso durante o sono, não a variação em relação a uma linha de base que essa chave carrega.
basal_metabolic_rateO Apple Health guarda a energia em repouso por intervalo, não uma taxa por dia. Ela sai como parte de total_calories.

Números, limites e resolução

  • Casas decimais. 3 para metros e litros; 2 para quilogramas, calorias, graus Celsius, mmol/L e os nutrientes; 1 para porcentagens, pressão arterial, frequência respiratória, VFC e VO2 máx. Os zeros finais são removidos, então 97.0 chega como 97. Contagens, batimentos por minuto e durações são números inteiros.
  • Por sincronização. Até 1000 registros novos para frequência cardíaca, passos e calorias totais, 500 para VFC e frequência respiratória, e 200 para cada um dos outros tipos. A sincronização seguinte continua de onde esta parou.
  • Resolução dos dados. Em O que enviar, frequência cardíaca, VFC, oxigênio no sangue e frequência respiratória podem ser enviados como uma média por 1, 5 ou 15 minutos ou por hora, com um mínimo e um máximo; passos, distância e as duas calorias, como uma soma. Todo tipo começa em todos os registros.

A página do payload do iOS traz todos os detalhes, e o JSON Schema do app para Android cobre os dois apps. Para o Android, veja Tipos de dados do Conexão Saúde, app por app.

Life Dashboard para iPhone

Ative seus tipos em O que enviar e toque em Prévia do payload para ver o que a próxima sincronização enviaria.

Baixar na App Store

€ 6,99 uma única vez na App Store, sem assinatura.

Compilar com o Xcode

Baixar o app para iPhone Referência do payload do iOS

O app de código aberto para iPhone que este guia usa. Sem conta, e os dados vão só para onde você apontar. Mais sobre o app.

Perguntas frequentes

Quantos tipos do Apple Health o app do iPhone lê?

28, cada um desativado até você ativá-lo em O que enviar. A menstruação envia duas chaves, fluxo e períodos, então um iPhone envia 29 chaves de payload.

Por que o iPhone não envia massa óssea nem temperatura da pele?

O Apple Health não tem tipo de massa óssea nem de água corporal, e guarda a temperatura absoluta do pulso durante o sono em vez da variação em relação a uma linha de base que o payload compartilhado carrega. A taxa metabólica basal sai dentro de total_calories.

A VFC de um iPhone é a mesma de um Android?

Não. O Apple Health guarda SDNN e o Conexão Saúde guarda RMSSD. As duas chegam em heart_rate_variability_millis, mas são medidas diferentes, então não tire média nem compare uma com a outra.

Quais tipos viram sensores no Home Assistant?

20 dos 28, com a pressão arterial como dois sensores. Os treinos ganham um sensor de último treino e os minutos de hoje e de ontem, e treinos e mindfulness entram nas estatísticas diárias, em horas. A partir da integração 1.2.0, suas refeições somam as calorias, as proteínas, os carboidratos e as gorduras que você consumiu hoje. Refeições isoladas e o monitoramento do ciclo não ganham sensor; um webhook recebe tudo por inteiro.

O app lê o Tempo de Uso ou o ECG?

Não. O Tempo de Uso não pode sair do iPhone: o iOS só o mostra dentro de uma sandbox que não consegue enviar nada para fora. Tudo o que está fora dos 28 tipos fica no Apple Health.