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.
| Tipo | Chave do payload | Valor e unidade | Home Assistant | Apple Watch |
|---|---|---|---|---|
| Passos | steps | count | Total de hoje | Sim, e o iPhone |
| Distância | distance | meters | Total de hoje | Sim, e o iPhone |
| Energia Ativa | active_calories | calories, kcal | Total de hoje | Sim |
| Energia Total | total_calories | calories, kcal | Total de hoje | Sim |
| Treinos | exercise | type, duration_seconds | Último treino, minutos de hoje e de ontem | Sim |
| Peso | weight | kilograms | Valor mais recente | Não |
| Altura | height | meters | Valor mais recente | Não |
| Percentual de Gordura Corporal | body_fat | percentage | Valor mais recente | Não |
| Massa Corporal Magra | lean_body_mass | kilograms | Valor mais recente | Não |
| Frequência Cardíaca | heart_rate | bpm | Valor mais recente | Sim |
| Frequência Cardíaca em Repouso | resting_heart_rate | bpm | Valor mais recente | Sim |
| Variabilidade da Frequência Cardíaca | heart_rate_variability | heart_rate_variability_millis, ms (SDNN) | Valor mais recente | Sim |
| Pressão Arterial | blood_pressure | systolic, diastolic, mmHg | Dois sensores | Não |
| Oxigênio no Sangue | oxygen_saturation | percentage | Valor mais recente | Alguns modelos e regiões |
| Frequência Respiratória | respiratory_rate | rate, respirações por minuto | Valor mais recente | Sim, durante o sono |
| Temperatura Corporal | body_temperature | celsius | Valor mais recente | Não |
| Temperatura Corporal Basal | basal_body_temperature | celsius | Valor mais recente | Não |
| Glicose no Sangue | blood_glucose | mmol_per_liter | Valor mais recente | Não |
| VO2 máx. | vo2_max | vo2_ml_per_min_per_kg | Valor mais recente | Sim, durante alguns treinos |
| Sono | sleep | duration_seconds, stages | Duração do último sono, tempo dormindo e horas por fase | Sim, com fases |
| Mindfulness | mindfulness | duration_seconds | Minutos por dia, nas estatísticas | Desconhecido |
| Água | hydration | liters | Última bebida | Não |
| Nutrição | nutrition | calories, gramas e mais 34 nutrientes | Calorias, proteínas, carboidratos e gorduras consumidos hoje | Não |
| Menstruação | menstruation_flow, menstruation_period | flow; start_time, end_time | Sem sensor | Não |
| Sangramento Intermenstrual | intermenstrual_bleeding | Só o horário | Sem sensor | Não |
| Resultado do Teste de Ovulação | ovulation_test | result | Sem sensor | Não |
| Qualidade do Muco Cervical | cervical_mucus | appearance, sensation | Sem sensor | Não |
| Atividade Sexual | sexual_activity | protection_used | Sem sensor | Nã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_caloriesvem 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,sleepingeunknown, que o Android também envia, ein_bed, que só um iPhone envia: o tempo na cama em volta das fases, que não é uma fase. - O
uuidde 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
sourceda 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 Android | Por que não |
|---|---|
speed | O app do iPhone ainda não lê a velocidade. |
bone_mass | O Apple Health não tem um tipo de massa óssea. |
body_water_mass | O Apple Health não tem um tipo de água corporal. |
skin_temperature | O 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_rate | O 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 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.