Types de données de l'API Google Health

Le tableau suivant contient la liste complète des types de données, avec plusieurs colonnes pour vous aider à comprendre la représentation de chaque type dans l'API Google Health, ainsi que le champ d'application de chacun.

Important : Le format des identifiants de type de données diffère lorsque le type de données comporte plusieurs mots. Dans un point de terminaison, le nom du type de données doit être en kebab case, comme body-fat. Toutefois, dans un paramètre de filtre, le nom du type de données doit être en snake case, comme body_fat.

Tableau : Types de données de l'API Google Health

Type de données   dataType Paramètre   filter	Type Record	Opérations disponibles	Champ d'application	Compatibilité avec les webhooks	Prise en charge des vrais zéros
Énergie active dépensée   active-energy-burned   active_energy_burned	Intervalle	list, reconcile, rollup, dailyRollup	activity_and_fitness
Minutes actives   active-minutes   active_minutes	Intervalle	list, reconcile, rollup, dailyRollup	activity_and_fitness
Minutes en zone active   active-zone-minutes   active_zone_minutes	Intervalle	list, reconcile, rollup, dailyRollup	activity_and_fitness
Niveau d'activité   activity-level   activity_level	Intervalle	list, reconcile	activity_and_fitness
Altitude   altitude   altitude	Intervalle	list, reconcile, rollup, dailyRollup	activity_and_fitness
Glycémie   blood-glucose   blood_glucose	Échantillon	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Masse grasse   body-fat   body_fat	Échantillon	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements
Calories brûlées dans la zone de fréquence cardiaque   calories-in-heart-rate-zone   calories_in_heart_rate_zone	Intervalle	rollup, dailyRollup	activity_and_fitness
Température corporelle   core-body-temperature   core_body_temperature	Échantillon	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Variabilité quotidienne de la fréquence cardiaque   daily-heart-rate-variability   daily_heart_rate_variability	Tous les jours	list, reconcile	health_metrics_and_measurements
Zones de fréquence cardiaque quotidienne   daily-heart-rate-zones   daily_heart_rate_zones	Tous les jours	list, reconcile	health_metrics_and_measurements
Saturation en oxygène quotidienne   daily-oxygen-saturation   daily_oxygen_saturation	Tous les jours	list, reconcile	health_metrics_and_measurements
Fréquence respiratoire quotidienne   daily-respiratory-rate   daily_respiratory_rate	Tous les jours	list, reconcile	health_metrics_and_measurements
Fréquence cardiaque au repos quotidienne   daily-resting-heart-rate   daily_resting_heart_rate	Tous les jours	list, reconcile	health_metrics_and_measurements
Dérivations quotidiennes de la température du sommeil   daily-sleep-temperature-derivations   daily_sleep_temperature_derivations	Tous les jours	list, reconcile	health_metrics_and_measurements
VO2 max quotidienne   daily-vo2-max   daily_vo2_max	Tous les jours	list, reconcile	activity_and_fitness
Distance   distance   distance	Intervalle	list, reconcile, rollup, dailyRollup	activity_and_fitness
Électrocardiogramme (ECG)   electrocardiogram   electrocardiogram	Session	list	ecg
Exercice   exercise   exercise	Session	list, get, reconcile, create, update, batchDelete	activity_and_fitness
Étages gravis   floors   floors	Intervalle	reconcile, rollup, dailyRollup	activity_and_fitness
Nourriture   food   food	Nourriture	list, get	nutrition
Unité de mesure des aliments   food-measurement-unit   food_measurement_unit	Nourriture	list, get	nutrition
Fréquence cardiaque   heart-rate   heart_rate	Échantillon	list, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Variabilité de la fréquence cardiaque   heart-rate-variability   heart_rate_variability	Échantillon	list, reconcile	health_metrics_and_measurements
Taille   height   height	Échantillon	list, get, reconcile, create, update, batchDelete	health_metrics_and_measurements
Journal d'hydratation   hydration-log   hydration_log	Session	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	nutrition
Notification de rythme irrégulier   irregular-rhythm-notification   irregular_rhythm_notification	Session	list	irn
Journal de nutrition   nutrition-log   nutrition_log	Échantillon	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	nutrition
Saturation en oxygène   oxygen-saturation   oxygen_saturation	Échantillon	list, reconcile	health_metrics_and_measurements
Résumé du sommeil avec la fréquence respiratoire   respiratory-rate-sleep-summary   respiratory_rate_sleep_summary	Échantillon	list, reconcile	health_metrics_and_measurements
VO2 max de la course   run-vo2-max   run_vo2_max	Échantillon	list, reconcile, rollup, dailyRollup	activity_and_fitness
Période sédentaire   sedentary-period   sedentary_period	Intervalle	list, reconcile, rollup, dailyRollup	activity_and_fitness
Sommeil   sleep   sleep	Session	list, get, reconcile, create, update, batchDelete	sommeil
Étapes   steps   steps	Intervalle	list, reconcile, rollup, dailyRollup	activity_and_fitness
Données sur les longueurs de nage   swim-lengths-data   swim_lengths_data	Intervalle	list, reconcile, rollup, dailyRollup	activity_and_fitness
Temps passé dans la zone de fréquence cardiaque   time-in-heart-rate-zone   time_in_heart_rate_zone	Intervalle	list, reconcile, rollup, dailyRollup	activity_and_fitness
Total des calories   total-calories   total_calories	Intervalle	rollup, dailyRollup	activity_and_fitness
VO2 Max   vo2-max   vo2_max	Échantillon	list, reconcile	activity_and_fitness
Pondération   weight   weight	Échantillon	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements

Disponibilité des données

Les mises à jour des données de l'utilisateur ne sont disponibles qu'après la synchronisation de son moniteur d'activité physique ou la saisie manuelle de nouvelles données dans l'app mobile ou l'application Web Fitbit. L'appareil Fitbit et l'app mobile Fitbit peuvent se synchroniser automatiquement toutes les 15 minutes lorsque l'app Fitbit est ouverte sur l'appareil mobile et que les deux disposent d'une connexion de données active et se trouvent à portée Bluetooth. Si l'utilisateur suit son activité avec MobileTrack, MobileTrack se synchronise toutes les heures tant que l'application est ouverte.

Accès tiers

Les appareils Fitbit ne peuvent pas communiquer directement avec des applications ni des services tiers. Ces appareils sont conçus pour communiquer et se synchroniser exclusivement avec l'application mobile Fitbit.

L'appareil synchronise automatiquement les données tout au long de la journée, chaque fois que l'app Fitbit est ouverte, ou toutes les 15 minutes si le Bluetooth est activé et que l'application s'exécute en arrière-plan. Une fois ce processus de synchronisation terminé, les données sont disponibles pour les services tiers via l'API Google Health.

Normes de distance

Les distances d'exercice, telles que elevationGainMillimeters, sont mesurées en millimètres comme unité standard pour les raisons suivantes :

1. Maintenir la précision des données : la raison la plus importante d'utiliser les millimètres est de s'assurer de ne perdre aucune précision dans les données que nous lisons et fournissons. L'utilisation d'une unité précise comme le millimètre nous permet de représenter les mesures avec une grande précision.
2. Standardisation : les millimètres sont l'unité standardisée conçue pour nos services. Cette cohérence permet de garantir une expérience uniforme pour les développeurs qui interagissent avec différentes parties de l'API.
3. Compatibilité étendue avec les systèmes de mesure : l'utilisation d'une unité de base comme le millimètre permet aux développeurs de convertir facilement les valeurs dans l'unité de leur choix, qu'ils travaillent avec le système métrique, impérial ou un autre système de mesure.

Durée variable des jours

La gestion du temps par l'API Health donne la priorité à l'heure de l'utilisateur pour tenir compte des durées de journée variables causées par le passage à l'heure d'été ou les voyages. Chaque point de données est stocké avec un code temporel UTC physique et le décalage UTC actif au moment de l'événement. Cela permet au système :

• Associez l'événement à un instant physique précis.
• Corrigez l'heure en fonction du contexte local de l'utilisateur pour l'agrégation.

Heure d'été

Lors du passage à l'heure d'hiver, la journée civile dure 25 heures. Le cumul pour cette date contiendra donc 25 heures de données. Le passage à l'heure d'été entraîne une journée civile de 23 heures, où l'heure revient à l'heure normale.

Voyages

Les voyages à travers les fuseaux horaires peuvent entraîner des variations encore plus importantes dans la durée physique d'un jour civil.

Utilisez le point de terminaison dailyRollUp pour résoudre les différences de fuseau horaire. Il attribue automatiquement les données au jour calendaire où elles ont été enregistrées, selon l'heure locale de l'utilisateur, ce qui permet de "rassembler" la journée malgré les changements de fuseau horaire.