Les API Google Fit, y compris l'API REST Google Fit, ne seront plus disponibles après le 30 juin 2025. Depuis le 1er mai 2024, les développeurs ne peuvent plus s'inscrire pour utiliser ces API.
Pour les données qui peuvent être enregistrées en continu (avec plusieurs points de données sur une période donnée), la plate-forme Google Fit peut agréger ces données et renvoyer les résultats calculés. Il peut s'agir d'une mesure moyenne ou d'un résumé/total. Vous pouvez gagner du temps sur ces calculs et présenter facilement aux utilisateurs de votre application des résumés ou des moyennes utiles en lisant des données globales.
Pour lire des données agrégées, vous devez choisir un type de données, une période et un élément par lequel les "buckets" (ou les regrouper). Vous pouvez scinder des données de différentes manières:
Période
Segmentez les données agrégées par heure ou par jour. Vous pouvez par exemple consulter le nombre de pas ou les calories brûlées par jour.
Type d'activité
Regroupez les données agrégées par type d'activité. Par exemple, pour les données de sommeil sur une semaine, il y aura un bucket pour chaque type d'activité de sommeil (léger, profond et paradoxal).
Segment d'activité
Regroupez les données agrégées par segment d'activité sur une période donnée. Par exemple, si un utilisateur a couru entre 9h et 10h, mais qu'il a couru pendant les 20 premières minutes, s'est assis pendant 10 minutes, a marché pendant 15 minutes et a couru pendant 15 minutes, ces quatre segments d'activité sont considérés comme 4 segments d'activité et renvoyaient 4 buckets.
Session
Utilisez les limites temporelles des sessions pour agréger les données. Par exemple, si un utilisateur a fait deux courses qui ont été enregistrées sous la forme de deux sessions (une course du matin et une course l'après-midi), vous pouvez regrouper les données par session pour connaître la vitesse moyenne de chaque course ou la moyenne de pas.
Activité
Utilisez ces types de données pour lire les données agrégées de santé et de bien-être.
Résumé de l'activité
Durée totale et nombre de segments associés à une activité spécifique au cours d'une période donnée.
Chaque point de données représente un résumé de tous les segments d'activité d'un type d'activité particulier sur un intervalle de temps spécifique.
Type d'activité effectuée par l'utilisateur. Consultez la liste des types d'activités ici.
duration (int—millisecondes)
Temps total passé sur une activité dans tous les segments de la période
nombre de segments (int — nombre)
Nombre de segments d'activité distincts sur l'intervalle de temps de ce point de données.
Android
Nom
com.google.activity.summary
Objet de type de données
AGGREGATE_ACTIVITY_SUMMARY
Champs (format : unités)
FIELD_ACTIVITY (int – énumération)
Type d'activité effectuée par l'utilisateur. Consultez la liste des types d'activités ici.
FIELD_DURATION (int — millisecondes)
Temps total passé sur une activité dans tous les segments de la période
FIELD_NUM_SEGMENTS (int – nombre)
Nombre de segments d'activité distincts sur l'intervalle de temps de ce point de données.
Résumé du métabolisme de base (MB)
Chaque point de données représente le métabolisme de base moyen, maximal et minimal de l'utilisateur au cours de la période, en kilocalories par jour. Cela est utile si l'utilisateur a pris ou perdu du poids et que, par conséquent, son MB a changé.
Le MB maximal de l'utilisateur sur une période donnée.
min (float-kcal par jour)
Le MB minimal de l'utilisateur sur une période donnée.
Android
Nom
com.google.calories.bmr.summary
Objet de type de données
AGGREGATE_BASAL_METABOLIC_RATE_SUMMARY
Champs (format : unités)
FIELD_AVERAGE (float – kcal par jour)
MB moyen de l'utilisateur sur une période donnée.
FIELD_MAX (float-kcal par jour)
Le MB maximal de l'utilisateur sur une période donnée.
FIELD_MIN (float-kcal par jour)
Le MB minimal de l'utilisateur sur une période donnée.
Résumé des calories brûlées
Total ou total des calories brûlées, en kilocalories sur une période donnée.
Ce type de données et ses champs sont identiques à ceux du type de données instantanées.
Résumé des points cardio
Chaque point de données représente le nombre de points cardio gagnés au cours de la période.
Nombre de points cardio gagnés au cours de la période, y compris les points gagnés grâce aux multiplicateurs (plus de points gagnés pour une activité plus intense).
duration (float – minutes)
Durée de cumul des points cardio, mesurée en minutes.
Android
Nom
com.google.heart_minutes.summary
Objet de type de données
AGGREGATE_HEART_POINTS
Champs (format : unités)
FIELD_INTENSITY (float – Points cardio)
Nombre de points cardio gagnés au cours de la période, y compris les points gagnés grâce aux multiplicateurs (plus de points gagnés pour une activité plus intense).
FIELD_DURATION (float – minutes)
Durée de cumul des points cardio, mesurée en minutes.
Résumé des minutes actives
Nombre total de minutes actives au cours de la période. Ce type de données et ces champs sont identiques à ceux du type de données instantanées.
Résumé de la consommation
Chaque point de données représente la puissance moyenne, maximale et minimale générée en watts par l'utilisateur sur une période donnée.
Puissance moyenne générée par l'utilisateur au cours de la période, en watts.
max (float – watts)
Puissance maximale générée par l'utilisateur au cours de la période, en watts.
min (float – watts)
Énergie minimale générée par l'utilisateur au cours de la période, en watts.
Android
Nom
com.google.power.summary
Objet de type de données
AGGREGATE_POWER_SUMMARY
Champs (format : unités)
FIELD_AVERAGE (float – watts)
Puissance moyenne générée par l'utilisateur au cours de la période, en watts.
FIELD_MAX (float – watts)
Puissance maximale générée par l'utilisateur au cours de la période, en watts.
FIELD_MIN (float – watts)
Énergie minimale générée par l'utilisateur au cours de la période, en watts.
Résumé du delta du nombre de pas
Chaque point de données représente le nombre total de pas effectués au cours de la période.
Ce type de données et ses champs sont identiques à ceux du type de données instantanées.
Corps
Utilisez ces types de données pour lire les données agrégées des mesures corporelles.
Résumé du pourcentage de masse grasse
Chaque point de données représente le pourcentage de masse grasse moyen, maximal et minimal de l'utilisateur sur une période donnée.
REST
Nom
com.google.body.fat.percentage.summary
Champs d'application des autorisations OAuth
https://www.googleapis.com/auth/fitness.body.read
Champs (format : unités)
moyenne (float – %)
Pourcentage moyen de l'utilisateur dans la masse corporelle totale qui est la masse grasse, sur une période donnée.
max (float – %)
Pourcentage maximal de la masse corporelle totale qui est la masse grasse par l'utilisateur sur une période donnée.
min (float – %)
Pourcentage minimal de masse corporelle totale qui correspond à la masse grasse, sur une période donnée.
Android
Nom
com.google.body.fat.percentage.summary
Objet de type de données
AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
Champs (format : unités)
FIELD_AVERAGE (float — %)
Pourcentage moyen de l'utilisateur dans la masse corporelle totale qui est la masse grasse, sur une période donnée.
FIELD_MAX (float — %)
Pourcentage maximal de la masse corporelle totale qui est la masse grasse par l'utilisateur sur une période donnée.
FIELD_MIN (float — %)
Pourcentage minimal de masse corporelle totale qui correspond à la masse grasse, sur une période donnée.
Résumé de la fréquence cardiaque
Chaque point de données représente la fréquence cardiaque moyenne, maximale et minimale de l'utilisateur au cours de la période, en battements par minute.
REST
Nom
com.google.heart_rate.summary
Champs d'application des autorisations OAuth
https://www.googleapis.com/auth/fitness.body.read
Champs (format : unités)
moyen (float-bpm)
Fréquence cardiaque moyenne de l'utilisateur en battements par minute, sur une période donnée.
max (float-bpm)
Fréquence cardiaque maximale de l'utilisateur en battements par minute, sur une période donnée.
min (float-bpm)
Fréquence cardiaque minimale de l'utilisateur en battements par minute, sur une période donnée.
Android
Nom
com.google.heart_rate.summary
Objet de type de données
AGGREGATE_HEART_RATE_SUMMARY
Champs (format : unités)
FIELD_AVERAGE (float – bpm)
Fréquence cardiaque moyenne de l'utilisateur en battements par minute, sur une période donnée.
FIELD_MAX (float – bpm)
Fréquence cardiaque maximale de l'utilisateur en battements par minute, sur une période donnée.
FIELD_MIN (float – bpm)
Fréquence cardiaque minimale de l'utilisateur en battements par minute, sur une période donnée.
Résumé de la taille
Chaque point de données représente la taille moyenne, maximale et minimale de l'utilisateur sur une période donnée, en mètres.
REST
Nom
com.google.height.summary
Champs d'application des autorisations OAuth
https://www.googleapis.com/auth/fitness.body.read
Champs (format : unités)
moyenne (float – mètres)
Taille moyenne de l'utilisateur sur une période donnée (en mètres).
max (float — mètres)
Taille maximale de l'utilisateur sur une période donnée, en mètres.
min (float — mètres)
Taille minimale de l'utilisateur sur une période donnée (en mètres).
Android
Nom
com.google.height.summary
Objet de type de données
AGGREGATE_HEIGHT_SUMMARY
Champs (format : unités)
FIELD_AVERAGE (float — mètres)
Taille moyenne de l'utilisateur sur une période donnée (en mètres).
FIELD_MAX (float — mètres)
Taille maximale de l'utilisateur sur une période donnée, en mètres.
FIELD_MIN (float — mètres)
Taille minimale de l'utilisateur sur une période donnée (en mètres).
Résumé de votre poids
Chaque point de données représente le poids moyen, maximal et minimal de l'utilisateur sur une période donnée, en kilogrammes.
REST
Nom
com.google.weight.summary
Champs d'application des autorisations OAuth
https://www.googleapis.com/auth/fitness.body.read
Champs (format : unités)
moyenne (float — kg)
Poids corporel moyen de l'utilisateur sur une période donnée, en kilogrammes.
max (float—kg)
Poids corporel maximal de l'utilisateur sur une période donnée, en kilogrammes.
min (float—kg)
Poids corporel minimal de l'utilisateur sur une période donnée, en kilogrammes.
Android
Nom
com.google.weight.summary
Objet de type de données
AGGREGATE_WEIGHT_SUMMARY
Champs (format : unités)
FIELD_AVERAGE (float—kg)
Poids corporel moyen de l'utilisateur sur une période donnée, en kilogrammes.
FIELD_MAX (float—kg)
Poids corporel maximal de l'utilisateur sur une période donnée, en kilogrammes.
FIELD_MIN (float—kg)
Poids corporel minimal de l'utilisateur sur une période donnée, en kilogrammes.
Emplacement
Utilisez ces types de données pour lire les données de localisation agrégées.
Delta de la distance
Chaque point de données représente la distance totale parcourue par l'utilisateur sur une période donnée, en mètres. Ce type de données et ses champs sont identiques à ceux du type de données instantanées.
Cadre de délimitation du lieu
Chaque point de données représente le cadre de délimitation calculé sur les points de localisation de l'utilisateur sur une période donnée. Chaque cadre de délimitation comporte quatre champs représentant ses quatre coins.
Latitude minimale du cadre de délimitation, représentée par un float, en degrés.
Faible longitude (float – degrés)
Longitude minimale du cadre de délimitation, représentée par un float, en degrés.
Haute latitude (float – degrés)
Latitude maximale du cadre de délimitation, représentée par un float, en degrés.
haute longitude (float – degrés)
Longitude maximale du cadre de délimitation, représentée par un float, en degrés.
Android
Nom
com.google.location.bounding_box
Objet de type de données
AGGREGATE_LOCATION_BOUNDING_BOX
Champs (format : unités)
FIELD_LOW_LATITUDE (float – degrés)
Latitude en degrés du coin inférieur gauche du cadre de délimitation, représenté par un float.
FIELD_LOW_LONGITUDE (float – degrés)
Longitude de l'angle inférieur gauche du cadre de délimitation, représentée par un float, en degrés.
FIELD_HIGH_LATITUDE (float – degrés)
Latitude en degrés du coin supérieur droit du cadre de délimitation, représenté par un float.
FIELD_HIGH_LONGITUDE (float – degrés)
Longitude de l'angle supérieur droit du cadre de délimitation, représentée par un float, en degrés.
Résumé de la vitesse
Chaque point de données représente les vitesses moyenne, maximale et minimale parcourue par l'utilisateur au cours d'une période donnée, exprimées en mètres par seconde.
Vitesse moyenne de l'utilisateur sur une période donnée (en mètres par seconde).
max (float — mètres par seconde)
Vitesse maximale de l'utilisateur sur une période donnée (en mètres par seconde).
min (float — mètres par seconde)
Vitesse minimale de l'utilisateur sur une période donnée (en mètres par seconde).
Android
Nom
com.google.speed.summary
Objet de type de données
AGGREGATE_SPEED_SUMMARY
Champs (format : unités)
moyenne (float – mètres par seconde)
Vitesse moyenne de l'utilisateur sur une période donnée (en mètres par seconde).
max (float — mètres par seconde)
Vitesse maximale de l'utilisateur sur une période donnée (en mètres par seconde).
min (float — mètres par seconde)
Vitesse minimale de l'utilisateur sur une période donnée (en mètres par seconde).
Nutrition
Utilisez ces types de données pour lire les données nutritionnelles agrégées.
Récapitulatif d'hydratation
Chaque point de données représente le volume total d'eau consommé par un utilisateur au cours d'une période donnée, en litres. Ce type de données et ses champs sont identiques à ceux du type de données instantanées.
Résumé nutritionnel
Chaque point de données représente la somme de toutes les entrées nutritionnelles sur une période donnée.
Dans le champ des nutriments, chaque valeur représente la somme des nutriments sur toutes les entrées de la période.
Si le nutriment ne figurait dans aucune des entrées, il ne figurera pas non plus dans la carte agrégée. Si toutes les entrées de la période concernent le même repas, le type de repas sera également défini.
Total des nutriments présents dans les aliments consommés au cours d'une période donnée.
Valeurs acceptées
"key": "calories" // Calories in kcal
"key": "fat.total" // Total fat in grams
"key": "fat.saturated" // Saturated fat in grams
"key": "fat.unsaturated" // Unsaturated fat in grams
"key": "fat.polyunsaturated" // Polyunsaturated fat in grams
"key": "fat.monounsaturated" // Monounsaturated fat in grams
"key": "fat.trans" // Trans fat in grams
"key": "cholesterol" // Cholesterol in milligrams
"key": "sodium" // Sodium in milligrams
"key": "potassium" // Potassium in milligrams
"key": "carbs.total" // Total carbohydrates in grams
"key": "dietary_fiber" // Dietary fiber in grams
"key": "sugar" // Amount of sugar in grams
"key": "protein" // Protein amount in grams
Android
Nom
com.google.nutrition.summary
Objet de type de données
AGGREGATE_NUTRITION_SUMMARY
Champs (format : unités)
FIELD_MEAL_TYPE (int – énumération)
Type de repas mangé par l'utilisateur (présent si toutes les entrées pour la période donnée concernent le même repas).
Total des nutriments présents dans les aliments consommés au cours d'une période donnée.
Valeurs acceptées
NUTRIENT_CALORIES // Calories in kcal
NUTRIENT_TOTAL_FAT // Total fat in grams
NUTRIENT_SATURATED_FAT // Saturated fat in grams
NUTRIENT_UNSATURATED_FAT // Unsaturated fat in grams
NUTRIENT_POLYUNSATURATED_FAT // Polyunsaturated fat in grams
NUTRIENT_MONOUNSATURATED_FAT // Monounsaturated fat in grams
NUTRIENT_TRANS_FAT // Trans fat in grams
NUTRIENT_CHOLESTEROL // Cholesterol in milligrams
NUTRIENT_SODIUM // Sodium in milligrams
NUTRIENT_POTASSIUM // Potassium in milligrams
NUTRIENT_TOTAL_CARBS // Total carbohydrates in grams
NUTRIENT_DIETARY_FIBER // Dietary fiber in grams
NUTRIENT_SUGAR // Amount of sugar in grams
NUTRIENT_PROTEIN // Protein amount in grams
Health
Utilisez ces types de données pour lire des données médicales et de santé agrégées.
Résumé de glycémie
Chaque point de données représente le taux ou la concentration de glycémie moyen, minimal et maximal au cours de la période, mesuré en mmol/L où 1 mmol/L correspond à 18 mg/dL.
Si les valeurs de chacun de ces champs sont identiques pour toutes les mesures effectuées au cours de la période, la valeur du champ s'affiche dans les données renvoyées:
relation temporelle avec un repas
relation temporelle avec le sommeil
source du spécimen
Si les valeurs sont différentes d'une mesure à l'autre, le champ sera exclu.
Taux ou concentration moyen de l'utilisateur dans le sang sur une période donnée.
max (float – mmol/L)
Taux ou concentration maximal de la glycémie de l'utilisateur sur une période donnée.
min (float – mmol/L)
Taux ou concentration minimal de glycémie de l'utilisateur sur une période donnée.
relation temporelle avec le repas (int – énumération) (champ facultatif)
Comparaison entre le moment où la mesure a été effectuée et celui où l'utilisateur a mangé.
Valeurs acceptées
"intVal": 1 // Reading wasn't taken before or after a meal
"intVal": 2 // Reading was taken during a fasting period
"intVal": 3 // Reading was taken before a meal
"intVal": 4 // Reading was taken after a meal
meal type (type de repas, int - énumération) (champ facultatif)
Le type de repas que l'utilisateur a mangé au moment de la lecture.
relation temporelle avec le sommeil (int – énumération) (champ facultatif)
Comparaison entre le moment où la mesure a été effectuée et celui où l'utilisateur a dormi.
Valeurs acceptées
"intVal": 1 // User was fully awake
"intVal": 2 // Before the user fell asleep
"intVal": 3 // After the user woke up
"intVal": 4 // While the user was still sleeping
Comparaison entre le moment où la mesure a été effectuée et celui où l'utilisateur a mangé.
Valeurs acceptées
FIELD_TEMPORAL_RELATION_TO_MEAL_GENERAL // Reading wasn't taken before or after a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_FASTING // Reading was taken during a fasting period
FIELD_TEMPORAL_RELATION_TO_MEAL_BEFORE_MEAL // Reading was taken before a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_AFTER_MEAL // Reading was taken after a meal
Comparaison entre le moment où la mesure a été effectuée et celui où l'utilisateur a dormi.
Valeurs acceptées
TEMPORAL_RELATION_TO_SLEEP_FULLY_AWAKE // User was fully awake.
TEMPORAL_RELATION_TO_SLEEP_BEFORE_SLEEP // Before the user fell asleep.
TEMPORAL_RELATION_TO_SLEEP_ON_WAKING // After the user woke up.
TEMPORAL_RELATION_TO_SLEEP_DURING_SLEEP // While the user was still sleeping.
Chaque point de données représente la pression artérielle moyenne, minimale et maximale au cours de la période, mesurée en mmHg.
Si les valeurs de chacun de ces champs sont identiques pour toutes les mesures effectuées au cours de la période, la valeur du champ s'affiche dans les données renvoyées:
position du corps
lieu de mesure
Si les valeurs sont différentes d'une mesure à l'autre, le champ sera exclu.
Position du corps de l'utilisateur au moment de la mesure.
Valeurs acceptées
BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining
Le groupe et la partie du groupe concernés par la mesure.
Valeurs acceptées
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_WRIST // Left wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_WRIST // Right wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_UPPER_ARM // Left upper arm
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_UPPER_ARM // Right upper arm
Résumé de la température corporelle
Chaque point de données représente la température corporelle moyenne, minimale et maximale de l'utilisateur sur une période donnée.
Il comprendra également l'emplacement de la mesure sur le corps, si celui-ci était le même pour tous les points de données de l'intervalle de temps.
Chaque point de données représente la saturation en oxygène du sang moyenne, minimale et maximale, ainsi que le débit d'oxygène supplémentaire de l'utilisateur pour un intervalle de temps donné.
Si les valeurs de chacun de ces champs sont identiques pour toutes les mesures effectuées au cours de la période, la valeur du champ s'affiche dans les données renvoyées:
mode d'administration de l'oxygénothérapie
système de saturation en oxygène
méthode de mesure de la saturation en oxygène
Si les valeurs sont différentes d'une mesure à l'autre, le champ sera exclu.
Peut être absent ou 1 si mesuré par l'oxymétrie de pouls.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.