Pour les données pouvant ê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écapitulatif/total. Vous pouvez gagner du temps en effectuant des calculs et en montrant aux utilisateurs les résumés ou les moyennes utiles en lisant les données agrégées.
Pour lire les données agrégées, vous devez choisir un type de données, une période et un emplacement de regroupement des données. Vous pouvez regrouper des données de différentes manières:
Période
Segmentez les données globales par heure ou par jour. (par exemple, le nombre de pas ou de calories brûlées chaque jour).
Type d'activité
Segmentez les données globales 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é
Segmentez les données globales par segment d'activité sur une période donnée. Par exemple, si un utilisateur a couru entre 9 h et 10 h, mais a couru pour les 20 premières minutes, s'est assis pendant 10 minutes, a marché pendant 15 minutes et s'est exécuté pendant 15 minutes, il s'agit de quatre segments d'activité qui renverront quatre buckets.
Session
Utilisez les limites temporelles des sessions pour agréger les données. Par exemple, si un utilisateur a effectué deux exécutions qui ont été enregistrées comme deux sessions (une course matinale et une course après-midi), vous pouvez regrouper par session pour connaître le nombre moyen de pas ou la vitesse moyenne de chaque exécution.
Activité
Utilisez ces types de données pour lire des données agrégées sur la santé et le bien-être.
Résumé de l'activité
Durée totale et nombre de segments pour une activité particulière sur une période donnée.
Chaque point de données représente un récapitulatif de tous les segments d'activité pour un type d'activité particulier sur un intervalle de temps donné.
Type d'activité de l'utilisateur. Consultez la liste des types d'activités.
duration (int - millisecondes)
Temps total consacré à une activité sur l'ensemble des segments de la période.
Nombre de segments (nombre : int)
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é de l'utilisateur. Consultez la liste des types d'activités.
FIELD_DURATION (int – millisecondes)
Temps total consacré à une activité sur l'ensemble des segments de la période.
FIELD_NUM_SEGMENTS (nombre : int)
Nombre de segments d'activité distincts sur l'intervalle de temps de ce point de données.
Résumé du métabolisme de base
Chaque point de données représente le débit métabolique de base, minimal et maximal de l'utilisateur sur une période donnée, en kilocalories par jour. Cela est utile si l'utilisateur a pris ou perdu du poids, et que son MB a donc changé.
Taux de lecture moyenne de l'utilisateur sur une période donnée.
max (float - kcal par jour)
Le modificateur de requête large de l'utilisateur sur une période donnée.
min (float - kcal par jour)
Le minimum de BMR 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)
Taux de lecture moyenne de l'utilisateur sur une période donnée.
FIELD_MAX (float - kcal par jour)
Le modificateur de requête large de l'utilisateur sur une période donnée.
FIELD_MIN (float - kcal par jour)
Le minimum de BMR de l'utilisateur sur une période donnée.
Résumé des calories brûlées
Calories brûlées (totales ou totales), 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é.
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.
Nombre de points cardio gagnés sur la période, y compris les points gagnés par les multiplicateurs (plus de points gagnés pour des activités plus intenses).
duration (float minutes)
Durée (en minutes) gagnée en points cardio.
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 sur la période, y compris les points gagnés par les multiplicateurs (plus de points gagnés pour des activités plus intenses).
FIELD_DURATION (float minutes)
Durée (en minutes) gagnée en points cardio.
Résumé des minutes actives
Nombre total de minutes actives sur la période donnée. Ce type de données et ces champs sont identiques à ceux du type de données instantané.
Résumé de la puissance
Chaque point de données représente la puissance moyenne, maximale et minimale en watts de l'utilisateur, sur une période donnée.
Puissance moyenne (en watts) de l'utilisateur sur la période.
max (float - watts)
Puissance maximale en watts générée par l'utilisateur au cours de la période.
min (float watts)
Puissance minimale en watts générée par l'utilisateur au cours de la période.
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 (en watts) de l'utilisateur sur la période.
FIELD_MAX (float - watts)
Puissance maximale en watts générée par l'utilisateur au cours de la période.
FIELD_MIN (float - watts)
Puissance minimale en watts générée par l'utilisateur au cours de la période.
Récapitulatif du delta du nombre de pas
Chaque point de données représente le nombre total de pas sur la période donnée.
Ce type de données et ses champs sont identiques à ceux du type de données instantané.
Corps
Utilisez ces types de données pour lire les données agrégées de mesure corporelle.
Récapitulatif du pourcentage de masse grasse
Chaque point de données représente le pourcentage de masse grasse moyenne, maximale et minimale 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)
average (float, en pourcentage)
Pourcentage moyen de la masse grasse totale de l'utilisateur sur une période donnée.
max (float – pourcentage)
Pourcentage maximal de la masse totale du corps par l'utilisateur sur la graisse, sur une période donnée.
min (float – pourcentage)
Pourcentage minimal de la masse totale du corps sous forme de 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)
Pourcentage moyen de la masse grasse totale de l'utilisateur sur une période donnée.
FIELD_MAX (float pour cent)
Pourcentage maximal de la masse totale du corps par l'utilisateur sur la graisse, sur une période donnée.
FIELD_MIN (float %)
Pourcentage minimal de la masse totale du corps sous forme de 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 la période donnée, 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)
average (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écapitulatif de la hauteur
Chaque point de données représente la hauteur 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)
Hauteur moyenne de l'utilisateur sur une période donnée, en mètres.
max (float mètres)
Hauteur maximale de l'utilisateur sur une période donnée, en mètres.
min (float mètres)
Hauteur 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)
Hauteur moyenne de l'utilisateur sur une période donnée, en mètres.
FIELD_MAX (float mètres)
Hauteur maximale de l'utilisateur sur une période donnée, en mètres.
FIELD_MIN (float mètres)
Hauteur minimale de l'utilisateur sur une période donnée, en mètres.
Résumé du poids
Chaque point de données représente la pondération moyenne, maximale et minimale 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 moyen de l'utilisateur sur une période donnée, en kilogrammes.
max (float - kg)
Poids maximal du corps de l'utilisateur sur une période donnée, en kilogrammes.
min (float - kg)
Poids 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 moyen de l'utilisateur sur une période donnée, en kilogrammes.
FIELD_MAX (float - kg)
Poids maximal du corps de l'utilisateur sur une période donnée, en kilogrammes.
FIELD_MIN (float - kg)
Poids 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.
Distance delta
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é.
Zone 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.
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ésumé de l'hydratation
Chaque point de données représente le volume total d'eau consommé par un utilisateur sur une période donnée, en litres. Ce type de données et ses champs sont identiques à ceux du type de données instantané.
Récapitulatif 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 non plus dans la carte globale. 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 contenus dans l'aliment 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 que l'utilisateur a mangé (présent si toutes les entrées de la période concernent le même repas).
Total des nutriments contenus dans l'aliment 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 niveau ou la concentration moyenne, minimale et maximale de glycémie sur 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 pendant la période, vous verrez la valeur du champ dans les données renvoyées:
relation temporelle avec un repas
rapport temporel au sommeil
source du spécimen
Si les valeurs diffèrent d'une mesure à l'autre, le champ est exclu.
Taux de glycémie ou concentration moyen de l'utilisateur sur une période donnée.
max (float – mmol/L)
Niveau maximal de glycémie ou concentration de l'utilisateur sur une période donnée.
min (float—mmol/L)
Taux de glycémie ou concentration minimal de l'utilisateur sur une période donnée.
Relation temporelle avec le repas (int : énumération) (champ facultatif)
La date de lecture et celle de l'utilisateur
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 (int : type d'énumération) (champ facultatif)
Type de repas servi par l'utilisateur au moment de la lecture.
Relation temporelle avec le sommeil (int : énumération) (champ facultatif)
Le moment où la mesure a été effectuée par rapport au moment 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
source du spécimen (int : énumération) (champ facultatif)
Type de fluide corporel utilisé pour mesurer la glycémie.
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
Le moment où la mesure a été effectuée par rapport 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 pression 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 pendant la période, vous verrez la valeur du champ dans les données renvoyées:
position du corps
lieu de mesure
Si les valeurs diffèrent d'une mesure à l'autre, le champ est exclu.
Position du corps de l'utilisateur lorsque la mesure a été effectuée.
Valeurs acceptées
BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining
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 l'emplacement de la mesure sur le corps, si l'emplacement de la mesure é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 moyenne, minimale et maximale, et le débit d'oxygène supplémentaire de l'utilisateur au cours d'un intervalle de temps.
Si les valeurs de chacun de ces champs sont identiques pour toutes les mesures effectuées pendant la période, vous verrez la valeur du champ dans les données renvoyées:
mode d'administration d'oxygène
système de saturation en oxygène
méthode de mesure de la saturation en oxygène
Si les valeurs diffèrent d'une mesure à l'autre, le champ est exclu.
Comment la saturation en oxygène est-elle mesurée ?
Peut être absent ou 1 s'il est 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.