Le API Google Fit, inclusa l'API REST Google Fit, non saranno più disponibili dopo il 30 giugno 2025. A partire dal 1° maggio 2024, gli sviluppatori non possono registrarsi per utilizzare queste API.
Per i dati che possono essere registrati in modo continuo (con più punti dati in uno stesso periodo di tempo)
periodo), la piattaforma Google Fit può aggregare questi dati e restituire i
i risultati calcolati. Può essere una misurazione media o un riepilogo/totale. Tu
puoi risparmiare tempo con questi calcoli e mostrare agli utenti della tua app riepiloghi o
facilmente le medie leggendo dati aggregati.
Per leggere i dati aggregati, devi scegliere un tipo di dati, un intervallo di tempo e qualcosa
a "bucket" (o raggruppare) i dati. Puoi eseguire il bucket di dati in diversi modi:
Periodo di tempo
Dati aggregati in bucket per all'ora o al giorno. Ad esempio, puoi vedere i passi o le calorie bruciate al giorno.
Tipo di attività
Dati aggregati del bucket per tipo di attività. Ad esempio, per i dati sul sonno di una settimana, sarà presente un bucket per ogni tipo di attività di sonno (leggera, profonda e REM).
Segmento attività
Crea un bucket di dati aggregati per segmenti di attività in un periodo di tempo. Ad esempio, se un utente è andato a correre tra le 9 e le 10, ma ha corso per i primi 20 minuti, si è seduto per 10 minuti, ha camminato per 15 minuti e ha corso per 15 minuti, vengono considerati 4 segmenti di attività e vengono restituiti 4 bucket.
Sessione
Utilizza i limiti temporali delle sessioni per aggregare i dati. Ad esempio, se un utente ha effettuato 2 corse registrate come 2 sessioni (una corsa mattutina e una corsa pomeridiana), puoi bucket per sessione per apprendere i passi o la velocità media di ogni corsa.
Attività
Utilizza questi tipi di dati per leggere dati aggregati su salute e benessere.
Riepilogo attività
Tempo totale e numero di segmenti per una particolare attività in un periodo di tempo.
Ciascun punto dati rappresenta un riepilogo di tutti i segmenti di attività per un
tipo di attività in un intervallo di tempo.
Il tipo di attività che l'utente stava svolgendo. Consulta l'elenco dei tipi di attività qui.
duration (int-millisecondi)
Il tempo totale trascorso su un'attività in tutti i segmenti nell'intervallo di tempo.
numero di segmenti (int - conteggio)
Il numero di segmenti di attività distinti nell'intervallo di tempo di questo punto dati.
Android
Nome
com.google.activity.summary
Oggetto tipo di dati
AGGREGATE_ACTIVITY_SUMMARY
Campi (formato: unità)
FIELD_ACTIVITY (int - enum)
Il tipo di attività che l'utente stava svolgendo. Consulta l'elenco dei tipi di attività qui.
FIELD_DURATION (int-millisecondi)
Il tempo totale trascorso su un'attività in tutti i segmenti nell'intervallo di tempo.
FIELD_NUM_SEGMENTS (int - conteggio)
Il numero di segmenti di attività distinti nell'intervallo di tempo di questo punto dati.
Riepilogo del tasso metabolico basale (BMR)
Ciascun punto dati rappresenta il tasso metabolico basale medio, massimo e minimo dell'utente
nell'intervallo di tempo, in kilocalorie al giorno. È utile se l'utente ha
ha guadagnato o perso peso e di conseguenza il suo metabolismo basale è cambiato.
Il metabolismo basale medio dell'utente in un periodo di tempo.
max (float - kcal al giorno)
Il metabolismo basale massimo dell'utente in un periodo di tempo.
min (float—kcal al giorno)
Il metabolismo basale minimo dell'utente in un periodo di tempo.
Android
Nome
com.google.calories.bmr.summary
Oggetto tipo di dati
AGGREGATE_BASAL_METABOLIC_RATE_SUMMARY
Campi (formato: unità)
FIELD_AVERAGE (float - kcal al giorno)
Il metabolismo basale medio dell'utente in un periodo di tempo.
FIELD_MAX (float - kcal al giorno)
Il metabolismo basale massimo dell'utente in un periodo di tempo.
FIELD_MIN (float - kcal al giorno)
Il metabolismo basale minimo dell'utente in un periodo di tempo.
Riepilogo Calorie bruciate
Le calorie bruciate totali o totali, in kilocalorie, in un periodo di tempo.
Questo tipo di dati e i suoi campi sono gli stessi dei dati istantanei
del testo.
Riepilogo dei Punti cardio
Ogni punto dati rappresenta il numero di Punti cardio guadagnati nel periodo di tempo.
Il numero di Punti cardio guadagnati nel periodo di tempo selezionato.
inclusi i punti guadagnati dai moltiplicatori (più punti guadagnati per
attività più intensa).
duration (float - minuti)
Il tempo in cui sono stati accumulati Punti cardio, misurato in minuti.
Android
Nome
com.google.heart_minutes.summary
Oggetto tipo di dati
AGGREGATE_HEART_POINTS
Campi (formato: unità)
FIELD_INTENSITY (float - Punti cardio)
Il numero di Punti cardio guadagnati nel periodo di tempo selezionato.
inclusi i punti guadagnati dai moltiplicatori (più punti guadagnati per
attività più intensa).
FIELD_DURATION (float - minuti)
Il tempo in cui sono stati accumulati Punti cardio, misurato in minuti.
Riepilogo Minuti di movimento
Il numero totale di minuti di movimento nel periodo di tempo. Questo tipo di dati e i campi
sono le stesse del tipo di dati istantaneo.
Riepilogo alimentazione
Ciascun punto dati rappresenta la potenza media, massima e minima generata dall'utente in watt in un determinato periodo di tempo.
La potenza media generata dall'utente nel periodo di tempo, espressa in watt.
max (float - watt)
La potenza massima generata dall'utente nel periodo di tempo specificato, in watt.
min (float - watt)
La potenza minima generata dall'utente nel periodo di tempo, espressa in watt.
Android
Nome
com.google.power.summary
Oggetto tipo di dati
AGGREGATE_POWER_SUMMARY
Campi (formato: unità)
FIELD_AVERAGE (float - watt)
La potenza media generata dall'utente nel periodo di tempo, espressa in watt.
FIELD_MAX (float - watt)
La potenza massima generata dall'utente nel periodo di tempo specificato, in watt.
FIELD_MIN (float - watt)
La potenza minima generata dall'utente nel periodo di tempo, espressa in watt.
Riepilogo delta conteggio passi
Ciascun punto dati rappresenta il numero totale di passaggi nel periodo di tempo.
Questo tipo di dati e i suoi campi sono gli stessi dei dati istantanei
del testo.
Corpo
Utilizza questi tipi di dati per leggere i dati aggregati di misurazione del corpo.
Riepilogo percentuale di grasso corporeo
Ciascun punto dati rappresenta la percentuale media, massima e minima di grasso corporeo dell'utente
in un determinato periodo di tempo.
REST
Nome
com.google.body.fat.percentage.summary
Ambiti delle autorizzazioni OAuth
https://www.googleapis.com/auth/fitness.body.read
Campi (formato: unità)
media (float - percentuale)
La percentuale media dell'utente della massa corporea totale composta da grasso corporeo in un periodo di tempo.
max (float - percentuale)
La percentuale massima di grasso corporeo totale dell'utente in un periodo di tempo.
min (float - percentuale)
La percentuale minima di grasso corporeo totale dell'utente in un periodo di tempo.
Android
Nome
com.google.body.fat.percentage.summary
Oggetto tipo di dati
AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
Campi (formato: unità)
FIELD_AVERAGE (float - percentuale)
La percentuale media dell'utente della massa corporea totale composta da grasso corporeo in un periodo di tempo.
FIELD_MAX (float - percentuale)
La percentuale massima di grasso corporeo totale dell'utente in un periodo di tempo.
FIELD_MIN (float - percentuale)
La percentuale minima di grasso corporeo totale dell'utente in un periodo di tempo.
Riepilogo battito cardiaco
Ciascun punto dati rappresenta il battito cardiaco medio, massimo e minimo dell'utente nel
di tempo, in battiti al minuto.
REST
Nome
com.google.heart_rate.summary
Ambiti delle autorizzazioni OAuth
https://www.googleapis.com/auth/fitness.body.read
Campi (formato: unità)
media (float-b/m)
Il battito cardiaco medio dell'utente in battiti al minuto in un periodo di tempo.
max (float - b/m)
Il battito cardiaco massimo dell'utente in battiti al minuto in un periodo di tempo.
min (float - b/m)
Il battito cardiaco minimo dell'utente in battiti al minuto in un periodo di tempo.
Android
Nome
com.google.heart_rate.summary
Oggetto tipo di dati
AGGREGATE_HEART_RATE_SUMMARY
Campi (formato: unità)
FIELD_AVERAGE (float - b/m)
Il battito cardiaco medio dell'utente in battiti al minuto in un periodo di tempo.
FIELD_MAX (float - b/m)
Il battito cardiaco massimo dell'utente in battiti al minuto in un periodo di tempo.
FIELD_MIN (float - b/m)
Il battito cardiaco minimo dell'utente in battiti al minuto in un periodo di tempo.
Riepilogo altezza
Ciascun punto dati rappresenta l'altezza media, massima e minima dell'utente in un determinato periodo di tempo
in metri.
REST
Nome
com.google.height.summary
Ambiti delle autorizzazioni OAuth
https://www.googleapis.com/auth/fitness.body.read
Campi (formato: unità)
media (float - metri)
L'altezza media dell'utente in un periodo di tempo, in metri.
max (float - metri)
L'altezza massima dell'utente in un periodo di tempo, in metri.
min (float - metri)
L'altezza minima dell'utente in un periodo di tempo, in metri.
Android
Nome
com.google.height.summary
Oggetto tipo di dati
AGGREGATE_HEIGHT_SUMMARY
Campi (formato: unità)
FIELD_AVERAGE (float - metri)
L'altezza media dell'utente in un periodo di tempo, in metri.
FIELD_MAX (float - metri)
L'altezza massima dell'utente in un periodo di tempo, in metri.
FIELD_MIN (float - metri)
L'altezza minima dell'utente in un periodo di tempo, in metri.
Riepilogo peso
Ciascun punto dati rappresenta il peso medio, massimo e minimo dell'utente su un
di tempo in chilogrammi.
REST
Nome
com.google.weight.summary
Ambiti delle autorizzazioni OAuth
https://www.googleapis.com/auth/fitness.body.read
Campi (formato: unità)
media (float-kg)
Il peso corporeo medio dell'utente in un periodo di tempo, in chilogrammi.
max (float - kg)
Il peso corporeo massimo dell'utente in un periodo di tempo, in chilogrammi.
min (float-kg)
Il peso corporeo minimo dell'utente in un periodo di tempo, in chilogrammi.
Android
Nome
com.google.weight.summary
Oggetto tipo di dati
AGGREGATE_WEIGHT_SUMMARY
Campi (formato: unità)
FIELD_AVERAGE (float - kg)
Peso medio dell'utente in un periodo di tempo, in chilogrammi.
FIELD_MAX (float - kg)
Il peso corporeo massimo dell'utente in un periodo di tempo, in chilogrammi.
FIELD_MIN (float - kg)
Il peso corporeo minimo dell'utente in un periodo di tempo, in chilogrammi.
Località
Utilizza questi tipi di dati per leggere dati aggregati sulla posizione.
Delta distanza
Ogni punto dati rappresenta la distanza totale percorsa dall'utente in un periodo di tempo
in metri. Questo tipo di dati e i suoi campi sono gli stessi della
tipo di dati istantaneo.
Riquadro di delimitazione della località
Ciascun punto dati rappresenta il delimitatore
predefinita calcolata sulla base del
da punti di località in un periodo di tempo. Ogni riquadro ha quattro campi
che rappresentano i quattro angoli del riquadro di delimitazione.
Latitudine minima del riquadro di delimitazione, rappresentata come un numero in virgola mobile, in gradi.
longitudine bassa (float - gradi)
Longitudine minima del riquadro di delimitazione, rappresentata come un numero in virgola mobile, in gradi.
latitudine alta (float-gradi)
Latitudine massima del riquadro di delimitazione, rappresentata come un numero in virgola mobile, in gradi.
longitudine alta (float - gradi)
Longitudine massima del riquadro di delimitazione, rappresentato come un numero in virgola mobile, in gradi.
Android
Nome
com.google.location.bounding_box
Oggetto tipo di dati
AGGREGATE_LOCATION_BOUNDING_BOX
Campi (formato: unità)
FIELD_LOW_LATITUDE (float - gradi)
Latitudine dell'angolo in basso a sinistra del riquadro di delimitazione, rappresentato come un numero mobile, in gradi.
FIELD_LOW_LONGITUDE (float: gradi)
Longitudine dell'angolo in basso a sinistra del riquadro di delimitazione, rappresentato come un numero in virgola mobile, in gradi.
FIELD_HIGH_LATITUDE (float - gradi)
Latitudine dell'angolo in alto a destra del riquadro di delimitazione, rappresentato come un numero in virgola mobile, in gradi.
FIELD_HIGH_LONGITUDE (float – gradi)
Longitudine dell'angolo in alto a destra del riquadro di delimitazione, rappresentato come un numero in virgola mobile, in gradi.
Riepilogo velocità
Ogni punto dati rappresenta la velocità media, massima e minima dell'utente.
percorse nell'arco di un determinato periodo di tempo, in metri al secondo.
La velocità media dell'utente nel corso di un determinato periodo di tempo, in metri al secondo.
max (float - metri al secondo)
La velocità massima dell'utente nel corso di un determinato periodo di tempo, in metri al secondo.
min (float - metri al secondo)
La velocità minima dell'utente in un determinato periodo di tempo, in metri al secondo.
Android
Nome
com.google.speed.summary
Oggetto tipo di dati
AGGREGATE_SPEED_SUMMARY
Campi (formato: unità)
media (float - metri al secondo)
La velocità media dell'utente nel corso di un determinato periodo di tempo, in metri al secondo.
max (float - metri al secondo)
La velocità massima dell'utente nel corso di un determinato periodo di tempo, in metri al secondo.
min (float - metri al secondo)
La velocità minima dell'utente in un determinato periodo di tempo, in metri al secondo.
Alimentazione
Utilizza questi tipi di dati per leggere i dati nutrizionali aggregati.
Riepilogo idratazione
Ogni punto dati rappresenta il volume totale di acqua consumata da un utente durante un
in litri. Questo tipo di dati e i suoi campi sono gli stessi della
tipo di dati istantaneo.
Riassunto dati nutrizionali
Ogni punto dati rappresenta la somma di tutte le voci relative all'alimentazione in un periodo di tempo.
Nel campo delle sostanze nutritive, ogni valore rappresenta la somma delle sostanze nutritive rispetto a tutte
delle voci nel periodo di tempo.
Se la sostanza nutriente non è presente in nessuna delle voci, non sarà presente nella mappa aggregata.
. Se tutte le voci nel periodo di tempo riguardano lo stesso pasto, il tipo di pasto
.
Nutrienti totali negli alimenti assunti in un periodo di tempo.
Valori accettati
"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
Nome
com.google.nutrition.summary
Oggetto tipo di dati
AGGREGATE_NUTRITION_SUMMARY
Campi (formato: unità)
FIELD_MEAL_TYPE (int - enum)
Il tipo di pasto che l'utente ha mangiato (presente se tutte le voci nel periodo di tempo riguardano lo stesso pasto).
Nutrienti totali negli alimenti assunti in un periodo di tempo.
Valori accettati
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
Salute
Utilizza questi tipi di dati per leggere dati medici e sanitari aggregati.
Riepilogo glicemia
Ogni punto dati rappresenta il livello medio, minimo e massimo di glicemia
o concentrazione nell'intervallo di tempo, misurata in mmol/L, dove 1 mmol/L è 18.
mg/dL.
Se i valori di ognuno di questi campi sono uguali per tutte le misurazioni effettuate
durante l'intervallo di tempo, vedrai il valore del campo nei dati restituiti:
relazione temporale con un pasto
relazione temporale con il sonno
origine del campione
Se i valori sono diversi nelle misurazioni, il campo verrà escluso.
Il livello o la concentrazione medi di glicemia dell'utente in un periodo di tempo.
max (float-mmol/L)
La concentrazione o il livello massimo di glicemia dell'utente in un periodo di tempo.
min (float-mmol/L)
La concentrazione o il livello minimo di glicemia dell'utente in un periodo di tempo.
Relazione temporale con il pasto (int-enum) (campo facoltativo)
Quando la lettura è stata rilevata rispetto a quando l'utente ha mangiato.
Valori accettati
"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-enum) (campo facoltativo)
Il tipo di pasto che l'utente ha mangiato quando è stata rilevata la lettura.
Quando la lettura è stata rilevata rispetto a quando l'utente ha mangiato.
Valori accettati
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
FIELD_MEAL_TYPE (int-enum) (campo facoltativo)
Il tipo di pasto che l'utente ha mangiato quando è stata rilevata la lettura.
Quando è stata rilevata la lettura rispetto a quando ha dormito l'utente.
Valori accettati
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.
Ciascun punto dati rappresenta la pressione sanguigna media, minima e massima su
l'intervallo di tempo, misurato in mmHg.
Se i valori di ognuno di questi campi sono uguali per tutte le misurazioni effettuate
durante l'intervallo di tempo, vedrai il valore del campo nei dati restituiti:
posizione del corpo
posizione di misurazione
Se i valori sono diversi nelle misurazioni, il campo verrà escluso.
La posizione del corpo dell'utente al momento della misurazione.
Valori accettati
BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining
Il gruppo e la parte del braccio in cui è stata effettuata la misurazione.
Valori accettati
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
Riepilogo temperatura corporea
Ciascun punto dati rappresenta la temperatura corporea media, minima e massima di
l'utente in un intervallo di tempo.
Avrà anche la posizione in cui è stata effettuata la misurazione sul corpo, se
la posizione di misurazione è stata la stessa per tutti i punti dati nell'intervallo di tempo.
Ciascun punto dati rappresenta la media, la minima e la massima quantità di ossigeno nel sangue
saturazione e velocità del flusso di ossigeno supplementare dell'utente in un intervallo di tempo.
Se i valori di ognuno di questi campi sono uguali per tutte le misurazioni effettuate
durante l'intervallo di tempo, vedrai il valore del campo nei dati restituiti:
modalità di somministrazione di ossigeno
sistema di saturazione dell'ossigeno
metodo di misurazione della saturazione di ossigeno
Se i valori sono diversi nelle misurazioni, il campo verrà escluso.
[null,null,["Ultimo aggiornamento 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."]]],[]]