Quels types de données Apple Health Life Dashboard envoie-t-il ?

L’application iPhone lit 28 types d’Apple Health (l’app Santé de l’iPhone), et chacun est désactivé tant que vous ne l’activez pas sous Données à envoyer, par catégorie ou avec L’essentiel ou Tous les types. Elle les envoie sous les clés de payload de l’application Android, avec les mêmes champs et les mêmes unités : pas, distance et calories, entraînements, poids et composition corporelle, fréquence cardiaque, fréquence cardiaque au repos et variabilité de la fréquence cardiaque, tension artérielle, glycémie, saturation en oxygène, fréquence respiratoire, VO2 max, sommeil avec ses phases, hydratation, nutrition, pleine conscience, température corporelle et suivi du cycle. Les règles partent sous deux clés : un iPhone envoie donc 29 des 34 clés de l’application Android.

Chaque enregistrement porte un uuid, celui de l’échantillon dans Apple Santé, et un champ source : le nom qu’Apple Santé donne à l’application ou à l’appareil qui l’a écrit. L’application ne fait que lire ; elle n’écrit jamais dans Apple Santé.

Par Owen Vogelaar, qui développe Life Dashboard 10 min de lecture

Obtenir l’application iPhone

Tous les types en un coup d’œil

La colonne Apple Watch indique les types que la montre enregistre d’après la documentation d’Apple ; le guide L’Apple Watch dans Home Assistant renvoie à chaque page. Les autres types viennent de l’iPhone, de ce que vous saisissez vous-même, ou d’applications qui écrivent dans Apple Santé.

TypeClé du payloadValeur et unitéHome AssistantApple Watch
PasstepscountTotal du jourOui, ainsi que l’iPhone
DistancedistancemetersTotal du jourOui, ainsi que l’iPhone
Énergie activeactive_caloriescalories, kcalTotal du jourOui
Énergie totaletotal_caloriescalories, kcalTotal du jourOui
Entraînementsexercisetype, duration_secondsDernier entraînement, minutes d’aujourd’hui et d’hierOui
PoidsweightkilogramsDernière valeurNon
TailleheightmetersDernière valeurNon
Pourcentage de graisse corporellebody_fatpercentageDernière valeurNon
Masse maigrelean_body_masskilogramsDernière valeurNon
Fréquence cardiaqueheart_ratebpmDernière valeurOui
Fréquence cardiaque au reposresting_heart_ratebpmDernière valeurOui
Variabilité de la fréquence cardiaqueheart_rate_variabilityheart_rate_variability_millis, ms (SDNN)Dernière valeurOui
Tension artérielleblood_pressuresystolic, diastolic, mmHgDeux capteursNon
Oxygène sanguinoxygen_saturationpercentageDernière valeurCertains modèles et régions
Fréquence respiratoirerespiratory_raterate, respirations par minuteDernière valeurOui, pendant le sommeil
Température corporellebody_temperaturecelsiusDernière valeurNon
Température basalebasal_body_temperaturecelsiusDernière valeurNon
Glycémieblood_glucosemmol_per_literDernière valeurNon
VO2 maxvo2_maxvo2_ml_per_min_per_kgDernière valeurOui, pendant certains entraînements
Sommeilsleepduration_seconds, stagesDurée du dernier sommeil, temps de sommeil et heures par phaseOui, avec les phases
Pleine consciencemindfulnessduration_secondsMinutes par jour, dans les statistiquesInconnu
EauhydrationlitersDernière boissonNon
Nutritionnutritioncalories, grammes et 34 autres nutrimentsCalories, protéines, glucides et lipides consommés aujourd’huiNon
Règlesmenstruation_flow, menstruation_periodflow; start_time, end_timePas de capteurNon
Saignements intermenstruelsintermenstrual_bleedingL’heure uniquementPas de capteurNon
Résultat du test d’ovulationovulation_testresultPas de capteurNon
Glaire cervicalecervical_mucusappearance, sensationPas de capteurNon
Activité sexuellesexual_activityprotection_usedPas de capteurNon

« Non » et « Inconnu » dans la colonne Apple Watch signifient que la documentation d’Apple sur la montre, telle qu’elle est citée sur ce site, ne décrit pas son enregistrement par la montre, pas que rien ne peut l’écrire. Pour voir ce qui écrit un type sur votre propre iPhone, ouvrez l’app Santé, trouvez le type et regardez sous Sources de données et accès.

Quelle source écrit quel type

  • Apple Watch : pas, distance, énergie active et au repos, entraînements, fréquence cardiaque, fréquence cardiaque au repos, variabilité de la fréquence cardiaque, sommeil avec ses phases, fréquence respiratoire pendant le sommeil, VO2 max pendant certains entraînements en extérieur, et oxygène sanguin sur les modèles et dans les régions où il existe. Le guide L’Apple Watch dans Home Assistant donne les détails et les pages d’Apple.
  • iPhone : pas et distance. Un iPhone sans montre n’enregistre généralement pas d’énergie au repos : total_calories vient donc surtout avec une montre.
  • Autres applications et appareils : les applications d’autres montres, bagues et balances, comme Garmin Connect, Oura et Withings, peuvent écrire dans Apple Santé, tout comme les applications où vous notez votre alimentation, l’eau, votre cycle ou vos méditations. Ce qu’elles écrivent dépend de l’application et de vos réglages dans celle-ci ; chaque enregistrement nomme l’application dans source.

Apple Santé garde en double une marche que l’iPhone et la montre ont tous deux enregistrée, une fois par appareil. Les daily_totals de chaque payload ne la comptent qu’une fois, selon l’ordre des sources de données que vous réglez dans l’app Santé : utilisez-les donc pour les totaux quotidiens.

Activité

Pas

Clé steps : count, un nombre entier, sur un intervalle allant de start_time à end_time. Jusqu’à 1000 nouveaux enregistrements par synchronisation.

Distance

Clé distance : meters, sur un intervalle. Apple Santé a un type de distance par genre d’activité, et l’application les lit tous : marche et course, vélo, natation, fauteuil roulant, sports de glisse sur neige et, à partir d’iOS 18, aviron, pagaie, ski de fond et patinage. Ils ne se chevauchent pas : les additionner ne compte donc rien deux fois. Un enregistrement n’indique pas de quelle activité il provient.

Énergie active

Clé active_calories : calories en kcal, sur un intervalle. L’énergie active d’Apple Santé.

Énergie totale

Clé total_calories : calories en kcal, sur un intervalle. Apple Santé n’a pas de type pour l’énergie totale : il s’agit donc de ses enregistrements d’énergie au repos et d’énergie active réunis. Un même échantillon d’énergie active fait ainsi partie à la fois de active_calories et de total_calories. Jusqu’à 1000 nouveaux enregistrements par synchronisation. Dans daily_totals, la valeur n’est envoyée que les jours où il y a de l’énergie au repos.

Entraînements

Clé exercise : type, start_time, end_time et duration_seconds, d’après les entraînements d’Apple Santé. type est l’activité en snake_case, par exemple running, walking, downhill_skiing ou hiit ; other correspond au type Autre d’Apple, ou à une activité d’un iOS plus récent que l’application. duration_seconds inclut les pauses et peut donc dépasser la durée d’entraînement qu’affiche l’app Santé. Android envoie ici un numéro sous forme de chaîne, par exemple "56" pour la course à pied.

Corps

Poids

Clé weight : kilograms, à un instant donné (time), avec jusqu’à 2 décimales : un poids saisi en livres résiste ainsi à la conversion.

Taille

Clé height : meters, à un instant donné.

Pourcentage de graisse corporelle

Clé body_fat : percentage, de 0 à 100, à un instant donné.

Masse maigre

Clé lean_body_mass : kilograms, à un instant donné.

Cœur et signes vitaux

Fréquence cardiaque

Clé heart_rate : bpm, un nombre entier, à un instant donné, un enregistrement par échantillon. Jusqu’à 1000 nouveaux enregistrements par synchronisation. Chaque échantillon a son propre uuid ; la forme <uuid>#<time> d’Android ne s’applique pas.

Fréquence cardiaque au repos

Clé resting_heart_rate : bpm, un nombre entier, à un instant donné.

Variabilité de la fréquence cardiaque

Clé heart_rate_variability : heart_rate_variability_millis, à un instant donné. C’est le SDNN, la mesure qu’Apple Santé enregistre. Android envoie sous la même clé le RMSSD, celle que Santé Connect (Health Connect) enregistre ; ce n’est pas le même chiffre : gardez-les donc séparés. Jusqu’à 500 nouveaux enregistrements par synchronisation.

Tension artérielle

Clé blood_pressure : systolic et diastolic en mmHg, à un instant donné, par mesure : les deux valeurs qu’une application a enregistrées ensemble. Pour les rares applications qui les enregistrent séparément, elles sont appariées quand elles se suivent à moins d’une seconde. Une valeur sans son autre moitié n’est pas envoyée. uuid est celui de l’échantillon systolique.

Température corporelle

Clé body_temperature : celsius, à un instant donné.

Température basale

Clé basal_body_temperature : celsius, à un instant donné.

Glycémie

Clé blood_glucose : mmol_per_liter, à un instant donné.

Oxygène sanguin

Clé oxygen_saturation : percentage, de 0 à 100, à un instant donné.

Fréquence respiratoire

Clé respiratory_rate : rate en respirations par minute, à un instant donné. Jusqu’à 500 nouveaux enregistrements par synchronisation.

VO2 max

Clé vo2_max : vo2_ml_per_min_per_kg, à un instant donné.

Sommeil et esprit

Sommeil

Clé sleep : session_end_time, duration_seconds et stages, chaque phase avec son propre stage, ses heures, son uuid et sa source. Apple Santé n’a pas de séance de sommeil : l’application regroupe donc les échantillons de phase en nuits, et un écart de plus d’une heure en commence une nouvelle.

  • Phases : light (le sommeil principal d’Apple), deep, rem, awake, sleeping et unknown, qu’Android envoie aussi, et in_bed, que seul un iPhone envoie : le temps passé au lit autour des phases, qui n’est pas une phase en soi.
  • L’uuid d’une nuit vient de sa première phase : il reste donc le même pendant que la nuit s’allonge. Remplacez la nuit quand elle revient plus longue. Une phase ajoutée plus tard renvoie la nuit entière.
  • La source de la nuit est l’application ou l’appareil qui a enregistré la plupart de ses phases.

Pleine conscience

Clé mindfulness : start_time, end_time et duration_seconds, d’après les applications qui écrivent des séances de pleine conscience dans Apple Santé. Pas de title, qu’Android peut envoyer.

Alimentation et boissons

Eau

Clé hydration : liters, sur un intervalle. L’eau d’Apple Santé.

Nutrition

Clé nutrition : calories, protein_grams, carbs_grams, fat_grams, name et 34 autres nutriments sous les clés d’Android, comme dietary_fibre_g, sugars_g, sodium_mg et caffeine_mg, sur un intervalle. Tous les champs sont facultatifs.

  • Un aliment noté par une application, avec tous ses nutriments, forme un seul enregistrement, avec son nom quand l’application en a donné un.
  • Les 34 autres nutriments ne sont lus que pour un aliment qui a aussi de l’énergie, des protéines, des glucides ou des lipides : un café noté avec la seule caféine n’est donc pas envoyé.
  • Apple Santé n’a pas de type pour les acides gras trans, les graisses insaturées, l’énergie issue des lipides, l’acide folique ni meal_type : ils ne viennent donc jamais d’un iPhone.

Suivi du cycle

Règles

Un interrupteur, deux clés. menstruation_flow contient flow à un instant donné, avec les valeurs du schéma commun light, medium, heavy ou unknown. menstruation_period ne contient que start_time et end_time : Apple Santé n’a pas d’enregistrement pour les règles, l’application les déduit donc des jours de flux consécutifs, et un écart de 48 heures au plus comble un jour manquant. L’uuid d’une période de règles vient de son premier jour de flux : remplacez-la donc quand elle revient plus longue.

Saignements intermenstruels

Clé intermenstrual_bleeding : uniquement time, l’heure.

Résultat du test d’ovulation

Clé ovulation_test : result à un instant donné : positive (pic de LH), high (pic d’œstrogènes), negative, inconclusive ou unknown.

Glaire cervicale

Clé cervical_mucus : appearance et sensation à un instant donné. Apple Santé n’enregistre pas de sensation : sensation vaut donc toujours unknown.

Activité sexuelle

Clé sexual_activity : protection_used à un instant donné : protected ou unprotected quand l’application source l’a enregistré, unknown sinon.

Avec MQTT, les entrées du suivi du cycle ne sont pas publiées, car un topic retained n’est pas un endroit pour des données de santé reproductive ; la température basale, elle, l’est. L’intégration Home Assistant et un webhook les reçoivent toutes.

Les cinq clés Android qu’un iPhone n’envoie jamais

Clé AndroidPourquoi
speedL’application iPhone ne lit pas encore la vitesse.
bone_massApple Santé n’a pas de type pour la masse osseuse.
body_water_massApple Santé n’a pas de type pour l’eau corporelle.
skin_temperatureApple Santé enregistre la température absolue au poignet pendant le sommeil, pas l’écart par rapport à une valeur de référence que transporte cette clé.
basal_metabolic_rateApple Santé enregistre l’énergie au repos par intervalle, pas un taux par jour. Elle part dans total_calories.

Nombres, limites et résolution

  • Décimales. 3 pour les mètres et les litres ; 2 pour les kilogrammes, les calories, les degrés Celsius, les mmol/L et les nutriments ; 1 pour les pourcentages, la tension artérielle, la fréquence respiratoire, la variabilité de la fréquence cardiaque et le VO2 max. Les zéros finaux sont supprimés : 97.0 arrive donc sous la forme 97. Les décomptes, les battements par minute et les durées sont des nombres entiers.
  • Par synchronisation. Jusqu’à 1000 nouveaux enregistrements pour la fréquence cardiaque, les pas et les calories totales, 500 pour la variabilité de la fréquence cardiaque et la fréquence respiratoire, et 200 pour chacun des autres types. La synchronisation suivante reprend là où celle-ci s’est arrêtée.
  • Résolution des données. Sous Données à envoyer, la fréquence cardiaque, la variabilité de la fréquence cardiaque, la saturation en oxygène et la fréquence respiratoire peuvent être envoyées sous forme d’une moyenne par 1, 5 ou 15 minutes ou par heure, avec un minimum et un maximum ; les pas, la distance et les deux types de calories sous forme de somme. Chaque type est réglé au départ sur chaque enregistrement.

La page du payload iOS donne tous les détails, et le schéma JSON de l’application Android couvre les deux applications. Pour Android, voir Les types de données de Santé Connect, application par application.

Life Dashboard pour iPhone

Activez vos types sous Données à envoyer et touchez Aperçu du payload pour voir ce que la prochaine synchronisation enverrait.

Télécharger dans l’App Store

6,99 € en achat unique sur l’App Store, sans abonnement.

Compiler avec Xcode

Obtenir l’application iPhone Référence du payload iOS

L’application iPhone open source utilisée dans ce guide. Sans compte, et les données ne vont que là où vous les envoyez. En savoir plus sur l’application.

Questions fréquentes

Combien de types Apple Santé l’application iPhone lit-elle ?

28, chacun désactivé tant que vous ne l’activez pas sous Données à envoyer. Les règles envoient deux clés, le flux et les périodes : un iPhone envoie donc 29 clés de payload.

Pourquoi l’iPhone n’envoie-t-il ni la masse osseuse ni la température cutanée ?

Apple Santé n’a pas de type pour la masse osseuse ni pour l’eau corporelle, et il enregistre la température absolue au poignet pendant le sommeil plutôt que l’écart par rapport à une valeur de référence que transporte le payload commun. Le métabolisme de base part dans total_calories.

La variabilité de la fréquence cardiaque (HRV) d’un iPhone est-elle la même que celle d’Android ?

Non. Apple Santé enregistre le SDNN et Santé Connect le RMSSD. Les deux arrivent dans heart_rate_variability_millis, mais ce sont des mesures différentes : n’en faites donc ni la moyenne ni la comparaison.

Quels types deviennent des capteurs dans Home Assistant ?

20 des 28, la tension artérielle comptant pour deux capteurs. Les entraînements donnent un capteur du dernier entraînement et les minutes d’aujourd’hui et d’hier, et les entraînements et la pleine conscience comptent dans les statistiques quotidiennes, en heures. À partir de l’intégration 1.2.0, vos repas s’additionnent pour donner les calories, les protéines, les glucides et les lipides consommés aujourd’hui. Les repas pris un par un et le suivi du cycle n’ont pas de capteur ; un webhook les reçoit en entier.

L’application lit-elle le Temps d’écran ou l’ECG ?

Non. Le Temps d’écran ne peut pas quitter l’iPhone : iOS ne le montre qu’à l’intérieur d’un bac à sable qui ne peut rien envoyer vers l’extérieur. Tout ce qui ne fait pas partie des 28 types reste dans Apple Santé.