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é.
| Type | Clé du payload | Valeur et unité | Home Assistant | Apple Watch |
|---|---|---|---|---|
| Pas | steps | count | Total du jour | Oui, ainsi que l’iPhone |
| Distance | distance | meters | Total du jour | Oui, ainsi que l’iPhone |
| Énergie active | active_calories | calories, kcal | Total du jour | Oui |
| Énergie totale | total_calories | calories, kcal | Total du jour | Oui |
| Entraînements | exercise | type, duration_seconds | Dernier entraînement, minutes d’aujourd’hui et d’hier | Oui |
| Poids | weight | kilograms | Dernière valeur | Non |
| Taille | height | meters | Dernière valeur | Non |
| Pourcentage de graisse corporelle | body_fat | percentage | Dernière valeur | Non |
| Masse maigre | lean_body_mass | kilograms | Dernière valeur | Non |
| Fréquence cardiaque | heart_rate | bpm | Dernière valeur | Oui |
| Fréquence cardiaque au repos | resting_heart_rate | bpm | Dernière valeur | Oui |
| Variabilité de la fréquence cardiaque | heart_rate_variability | heart_rate_variability_millis, ms (SDNN) | Dernière valeur | Oui |
| Tension artérielle | blood_pressure | systolic, diastolic, mmHg | Deux capteurs | Non |
| Oxygène sanguin | oxygen_saturation | percentage | Dernière valeur | Certains modèles et régions |
| Fréquence respiratoire | respiratory_rate | rate, respirations par minute | Dernière valeur | Oui, pendant le sommeil |
| Température corporelle | body_temperature | celsius | Dernière valeur | Non |
| Température basale | basal_body_temperature | celsius | Dernière valeur | Non |
| Glycémie | blood_glucose | mmol_per_liter | Dernière valeur | Non |
| VO2 max | vo2_max | vo2_ml_per_min_per_kg | Dernière valeur | Oui, pendant certains entraînements |
| Sommeil | sleep | duration_seconds, stages | Durée du dernier sommeil, temps de sommeil et heures par phase | Oui, avec les phases |
| Pleine conscience | mindfulness | duration_seconds | Minutes par jour, dans les statistiques | Inconnu |
| Eau | hydration | liters | Dernière boisson | Non |
| Nutrition | nutrition | calories, grammes et 34 autres nutriments | Calories, protéines, glucides et lipides consommés aujourd’hui | Non |
| Règles | menstruation_flow, menstruation_period | flow; start_time, end_time | Pas de capteur | Non |
| Saignements intermenstruels | intermenstrual_bleeding | L’heure uniquement | Pas de capteur | Non |
| Résultat du test d’ovulation | ovulation_test | result | Pas de capteur | Non |
| Glaire cervicale | cervical_mucus | appearance, sensation | Pas de capteur | Non |
| Activité sexuelle | sexual_activity | protection_used | Pas de capteur | Non |
« 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_caloriesvient 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,sleepingetunknown, qu’Android envoie aussi, etin_bed, que seul un iPhone envoie : le temps passé au lit autour des phases, qui n’est pas une phase en soi. - L’
uuidd’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
sourcede 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é Android | Pourquoi |
|---|---|
speed | L’application iPhone ne lit pas encore la vitesse. |
bone_mass | Apple Santé n’a pas de type pour la masse osseuse. |
body_water_mass | Apple Santé n’a pas de type pour l’eau corporelle. |
skin_temperature | Apple 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_rate | Apple 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.
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é.