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 en une seule fois)
période), la plate-forme Google Fit peut regrouper ces données et renvoyer
les résultats calculés. Il peut s'agir d'une mesure moyenne ou d'un récapitulatif/total. Toi
vous pouvez gagner du temps sur ces calculs et proposer aux utilisateurs de votre application des résumés ou
en lisant des données agrégées.
Pour lire des données agrégées, vous devez choisir un type de données, une période
vers "bucket" (ou de regrouper) les données par. Vous pouvez segmenter des données de différentes manières:
Période
Regroupez les données par heure ou par jour. (par exemple, le nombre de pas ou les calories brûlées chaque jour).
Type d'activité
Regroupez les données par type d'activité. Par exemple, pour les données de sommeil sur une semaine, il y aura un seau 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 a couru les 20 premières minutes, s'est assis pendant 10 minutes, a marché pendant 15 minutes et a couru 15 minutes, cela représente 4 segments d'activité et renvoie 4 buckets.
Session
Agrégez les données à l'aide des limites temporelles des sessions. Par exemple, si un utilisateur a effectué deux courses qui ont été enregistrées comme deux sessions (une course du matin et une course de l'après-midi), vous pouvez segmenter par session pour connaître le nombre de pas ou la vitesse moyenne de chaque course.
Activité
Utilisez ces types de données pour lire des données agrégées de santé et de bien-être.
Résumé de l'activité
Durée totale et nombre de segments d'une activité particulière au cours d'une période donnée.
Chaque point de données représente un récapitulatif de tous les segments d'activité d'un segment particulier
d'activité sur un intervalle de temps.
Type d'activité réalisée par l'utilisateur. Pour consulter la liste des types d'activités, cliquez ici.
duration (durée) (int – millisecondes)
Temps total passé sur une activité sur tous les segments de la période.
number of segments (nombre de segments) (int – nombre)
Nombre de segments d'activité distincts au cours de 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é réalisée par l'utilisateur. Pour consulter la liste des types d'activités, cliquez ici.
FIELD_DURATION (int – millisecondes)
Temps total passé sur une activité sur tous les segments de la période.
FIELD_NUM_SEGMENTS (int – nombre)
Nombre de segments d'activité distincts au cours de l'intervalle de temps de ce point de données.
Résumé du taux métabolique de base (MB)
Chaque point de données représente le métabolisme de base moyen, maximal et minimal de l'utilisateur
sur la période, en kilocalories par jour. C'est utile si l'utilisateur a
pris ou perdu du poids. Par conséquent, son MB a changé.
Le MB moyen de l'utilisateur sur une période donnée.
max (float – kcal par jour)
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)
Le 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
Nombre total ou total de calories brûlées, en kilocalories, sur une période donnée.
Ce type de données et ses champs sont les mêmes que pour les données instantanées
d'entrée.
Récapitulatif des points cardio
Chaque point de données représente le nombre de points cardio gagnés au cours de la période.
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)
Puissance 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)
Puissance minimale générée par l'utilisateur au cours de la période, en watts.
Résumé delta du nombre de pas
Chaque point de données représente le nombre total de pas au cours de la période.
Ce type de données et ses champs sont les mêmes que pour les données instantanées
d'entrée.
Corps
Utilisez ces types de données pour lire les données globales sur les données 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 – pour cent)
Pourcentage moyen de masse grasse de l'utilisateur correspondant à la masse grasse, sur une période donnée.
max (float – pour cent)
Pourcentage maximal de masse grasse de l'utilisateur correspondant à la masse grasse, sur une période donnée.
min (float – pour cent)
Pourcentage minimal de masse grasse de l'utilisateur correspondant à 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 – pour cent)
Pourcentage moyen de masse grasse de l'utilisateur correspondant à la masse grasse, sur une période donnée.
FIELD_MAX (float – pour cent)
Pourcentage maximal de masse grasse de l'utilisateur correspondant à la masse grasse, sur une période donnée.
FIELD_MIN (float – pour cent)
Pourcentage minimal de masse grasse de l'utilisateur correspondant à 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 sur le
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)
moyenne (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 au cours d'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 au cours d'une période, en mètres.
max (float – mètres)
Taille maximale de l'utilisateur au cours d'une période, en mètres.
min (float – mètres)
Taille minimale de l'utilisateur au cours d'une période, 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 au cours d'une période, en mètres.
FIELD_MAX (float – mètres)
Taille maximale de l'utilisateur au cours d'une période, en mètres.
FIELD_MIN (float – mètres)
Taille minimale de l'utilisateur au cours d'une période, en mètres.
Résumé du poids
Chaque point de données représente le poids moyen, maximal et minimal de l'utilisateur sur une
période, 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)
moyen (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.
Lieu
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 au cours d'une période
en mètres. Ce type de données et ses champs sont les mêmes que pour
type de données instantanée.
Cadre de délimitation d'emplacement
Chaque point de données représente la limite
case calculée sur la base de données
de localisation sur une période donnée. Chaque cadre de délimitation comporte quatre champs
représentant les quatre coins du cadre de délimitation.
Latitude minimale du cadre de délimitation, représentée sous forme de nombre décimal, en degrés.
faible longitude (float degrés)
Longitude minimale du cadre de délimitation, représentée sous forme de nombre décimal, en degrés.
Haute latitude (float – degrés)
Latitude maximale du cadre de délimitation, représentée sous forme de nombre décimal, en degrés.
longitude élevée (float – degrés)
Longitude maximale du cadre de délimitation, représentée sous forme de nombre décimal, 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 de l'angle inférieur gauche du cadre de délimitation, représentée sous forme de float, en degrés.
FIELD_LOW_LONGITUDE (float – degrés)
Longitude en degrés de l'angle inférieur gauche du cadre de délimitation, représentée sous forme de float.
FIELD_HIGH_LATITUDE (float degrés)
Latitude de l'angle supérieur droit du cadre de délimitation, représentée sous forme de float, en degrés.
FIELD_HIGH_LONGITUDE (float degrés)
Longitude en degrés de l'angle supérieur droit du cadre de délimitation, représentée sous forme de float.
Résumé de la vitesse
Chaque point de données représente la vitesse moyenne, maximale et minimale de l'utilisateur
parcourus au cours d'une période donnée, exprimés en mètres par seconde.
Vitesse moyenne de l'utilisateur sur une période donnée, exprimée en mètres par seconde.
max (float – mètres par seconde)
Vitesse maximale de l'utilisateur sur une période donnée, exprimée en mètres par seconde.
min (float – mètres par seconde)
Vitesse minimale de l'utilisateur sur une période donnée, exprimé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, exprimée en mètres par seconde.
max (float – mètres par seconde)
Vitesse maximale de l'utilisateur sur une période donnée, exprimée en mètres par seconde.
min (float – mètres par seconde)
Vitesse minimale de l'utilisateur sur une période donnée, exprimée en mètres par seconde.
Nutrition
Utilisez ces types de données pour lire des données nutritionnelles agrégées.
Résumé de l'hydratation
Chaque point de données représente le volume total d'eau consommé par un utilisateur sur une
période, en litres. Ce type de données et ses champs sont les mêmes que pour
type de données instantanée.
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 l'ensemble
des entrées de la période.
Si le nutriment ne figure dans aucune des entrées, il ne figurera pas dans le mappage agrégé
non plus. Si toutes les entrées de la période concernent le même repas, le type de repas
est également défini.
Nombre total de nutriments consommés par les aliments sur 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 consommé par l'utilisateur (présent si toutes les entrées de la période concernent le même repas).
Nombre total de nutriments consommés par les aliments sur 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
Santé
Utilisez ces types de données pour lire des données médicales et de santé agrégées.
Résumé de la glycémie
Chaque point de données représente le taux de glycémie moyen, minimal et maximal
ou concentration sur la période, mesurée en mmol/L où 1 mmol/L est égal à 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, vous verrez la valeur du champ 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 est exclu.
Concentration ou taux de glycémie moyens de l'utilisateur sur une période donnée.
max (float – mmol/L)
Concentration ou taux de glycémie maximal de l'utilisateur sur une période donnée.
min (float – mmol/L)
Concentration ou taux de glycémie minimaux de l'utilisateur sur une période donnée.
relation temporelle avec le repas (int – énumération) (champ facultatif)
Le moment où la lecture a été effectuée et le moment 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
type de repas (int – énumération) (champ facultatif)
Type de repas que l'utilisateur a mangé au moment de la lecture.
Le moment où la lecture a été effectuée et le moment 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
Date et heure de la lecture comparées au moment 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 tension artérielle moyenne, minimale et maximale sur
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, vous verrez la valeur du champ 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 est 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
Bras et partie du bras dont la mesure a été effectuée.
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 indique également le lieu où la mesure a été effectuée sur le corps.
le lieu de mesure était le même pour tous les points de données de l'intervalle de temps.
Chaque point de données représente l'oxygène dans le sang moyen, minimal et maximal
la saturation et le débit d'oxygène supplémentaire
de l'utilisateur pour un intervalle de temps.
Si les valeurs de chacun de ces champs sont identiques pour toutes les mesures effectuées
au cours de la période, vous verrez la valeur du champ dans les données renvoyées:
mode d'administration d'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 est exclu.
Ce champ peut être absent ou 1 si la mesure est effectuée par 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.
Dernière mise à jour le 2024/08/22 (UTC).
[null,null,["Dernière mise à jour le 2024/08/22 (UTC)."],[[["Google Fit uses aggregate data types to provide summaries of health and wellness metrics, like steps, calories, and heart rate, over specific time periods."],["Developers can retrieve aggregated data by specifying the data type, time range, and how the data should be grouped (e.g., by time period, activity type, or session)."],["Data is categorized into activity, body, and location, each with specific data types and fields providing aggregated values like totals, averages, minimums, and maximums."],["Aggregate data types are read-only, meaning you can only retrieve data, not write or modify it."],["Accessing aggregate data types requires appropriate OAuth permissions, and Google Fit offers both REST and Android APIs for retrieval."]]],[]]