As APIs Google Fit, incluindo a API REST Google Fit, não estarão mais disponíveis após 30 de junho de 2025. Desde 1o de maio de 2024, os desenvolvedores não podem se inscrever para usar essas APIs.
Para dados que podem ser registrados continuamente (com vários pontos de dados ao longo de um período), a plataforma Google Fit pode agregar esses dados e retornar os
resultados calculados. Pode ser uma medida média ou um resumo/total. É possível
poupar tempo nesses cálculos e mostrar aos usuários resumos ou médias
úteis com facilidade lendo dados agregados.
Para ler dados agregados, você precisa escolher um tipo de dados, um intervalo de tempo e algo para "bucket" (ou agrupar) os dados. É possível agrupar dados de algumas maneiras diferentes:
Período
Agrupe os dados agregados por hora ou dia. Por exemplo, confira os passos ou as calorias queimadas por dia.
Tipo de atividade
Agrupe os dados agregados por tipo de atividade. Por exemplo, para dados de sono de uma semana, haverá um intervalo para cada tipo de atividade de sono (leve, profundo e REM).
Segmento de atividade
Agrupe os dados agregados por segmentos de atividade ao longo de um período. Por exemplo, se um usuário foi para uma corrida entre 9h e 10h, mas correu pelos primeiros 20 minutos, sentou por 10 minutos, percorreu 15 minutos e correu por 15 minutos, esses são considerados 4 segmentos de atividade e retornariam 4 intervalos.
Sessão
Usar os limites de tempo das sessões para agregar dados. Por exemplo, se um usuário realizou duas corridas que foram registradas como duas sessões (uma corrida de manhã e uma corrida à tarde), você poderá agrupar por sessão para saber a média de passos ou a velocidade média de cada corrida.
Atividade
Use esses tipos de dados para ler dados agregados de saúde e bem-estar.
Resumo de atividades
Tempo total e número de segmentos de uma atividade específica durante um período.
Cada ponto de dados representa um resumo de todos os segmentos de um tipo de atividade
específico em um intervalo de tempo.
O tipo de atividade que o usuário estava realizando. Veja a lista de tipos de atividade aqui.
duração (int — milissegundos)
O tempo total gasto em uma atividade em todos os segmentos no período.
número de segmentos (int - contagem)
É o número de segmentos de atividade distintos no intervalo de tempo desse ponto de dados.
Android
Nome
com.google.activity.summary
Objeto de tipo de dados
AGGREGATE_ACTIVITY_SUMMARY
Campos (format—units)
FIELD_ACTIVITY (int: enumeração)
O tipo de atividade que o usuário estava realizando. Veja a lista de tipos de atividade aqui.
FIELD_DURATION (int — milissegundos)
O tempo total gasto em uma atividade em todos os segmentos no período.
FIELD_NUM_SEGMENTS (int – contagem)
É o número de segmentos de atividade distintos no intervalo de tempo desse ponto de dados.
Resumo da taxa metabólica basal (TMB)
Cada ponto de dados representa a taxa metabólica basal máxima e mínima do usuário
ao longo do período, em quilocalorias por dia. Isso é útil quando o usuário
ganhou ou perdeu peso e, portanto, a TMB mudou.
As calorias agregadas ou totais queimadas, em quilocalorias, ao longo de um período.
Esse tipo de dados e os campos dele são os mesmos do tipo de dados
instantâneos.
Resumo dos Pontos cardio
Cada ponto de dados representa o número de Pontos cardio ganhos no período.
É o número de Pontos cardio ganhos no período,
incluindo os que foram conquistados por multiplicadores (mais pontos ganhos por
atividades mais intensas).
duração (float minutos)
Duração dos Pontos cardio (em minutos).
Android
Nome
com.google.heart_minutes.summary
Objeto de tipo de dados
AGGREGATE_HEART_POINTS
Campos (format—units)
FIELD_INTENSITY (float: pontos de cardio)
É o número de Pontos cardio ganhos no período,
incluindo os que foram conquistados por multiplicadores (mais pontos ganhos por
atividades mais intensas).
FIELD_DURATION (float minutos)
Duração dos Pontos cardio (em minutos).
Resumo dos Minutos em movimento
O total de minutos em movimento durante o período. Esse tipo de dados e esses campos
são os mesmos do tipo de dados instantâneos.
Resumo do poder
Cada ponto de dados representa a potência média, máxima e mínima do usuário gerada em watts, durante um período de tempo.
A energia média do usuário gerada no período de tempo, em watts.
max (float—watts)
A energia máxima do usuário gerada no período de tempo, em watts.
min (float—watts)
A energia mínima do usuário gerada no período de tempo, em watts.
Android
Nome
com.google.power.summary
Objeto de tipo de dados
AGGREGATE_POWER_SUMMARY
Campos (format—units)
FIELD_AVERAGE (float—watts)
A energia média do usuário gerada no período de tempo, em watts.
FIELD_MAX (float—watts)
A energia máxima do usuário gerada no período de tempo, em watts.
FIELD_MIN (float—watts)
A energia mínima do usuário gerada no período de tempo, em watts.
Resumo do delta da contagem de passos
Cada ponto de dados representa o número total de etapas ao longo do período.
Esse tipo de dados e os campos dele são os mesmos do tipo de dados
instantâneos.
Texto
Use esses tipos de dados para ler dados agregados de medidas corporais.
Resumo do percentual de gordura corporal
Cada ponto de dados representa o percentual de gordura corporal média, máxima e mínima do usuário
durante um período.
REST
Nome
com.google.body.fat.percentage.summary
Escopos de permissão do OAuth
https://www.googleapis.com/auth/fitness.body.read
Campos (format—units)
média (float%%)
A porcentagem média do usuário de massa corporal total que é uma gordura corporal durante um período.
máx. (float—percentual)
A porcentagem máxima do usuário de massa corporal total que é gordura corporal ao longo de um período.
min (float%%)
A porcentagem mínima do usuário de massa corporal total que é gordura corporal ao longo de um período.
Android
Nome
com.google.body.fat.percentage.summary
Objeto de tipo de dados
AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
Campos (format—units)
FIELD_AVERAGE (float:%)
A porcentagem média do usuário de massa corporal total que é uma gordura corporal durante um período.
FIELD_MAX (float:%)
A porcentagem máxima do usuário de massa corporal total que é gordura corporal ao longo de um período.
FIELD_MIN (float%%)
A porcentagem mínima do usuário de massa corporal total que é gordura corporal ao longo de um período.
Resumo da frequência cardíaca
Cada ponto de dados representa a frequência cardíaca média, máxima e mínima do usuário durante
o período, em batimentos por minuto.
REST
Nome
com.google.heart_rate.summary
Escopos de permissão do OAuth
https://www.googleapis.com/auth/fitness.body.read
Campos (format—units)
média (float - bpm)
A frequência cardíaca média do usuário em batimentos por minuto, durante um período.
máx. (float - bpm)
A frequência cardíaca máxima do usuário em batimentos por minuto, durante um período.
min (float - bpm)
A frequência cardíaca mínima do usuário em batimentos por minuto, durante um período.
Android
Nome
com.google.heart_rate.summary
Objeto de tipo de dados
AGGREGATE_HEART_RATE_SUMMARY
Campos (format—units)
FIELD_AVERAGE (float - bpm)
A frequência cardíaca média do usuário em batimentos por minuto, durante um período.
FIELD_MAX (float - bpm)
A frequência cardíaca máxima do usuário em batimentos por minuto, durante um período.
FIELD_MIN (float - bpm)
A frequência cardíaca mínima do usuário em batimentos por minuto, durante um período.
Resumo da altura
Cada ponto de dados representa a altura média, máxima e mínima do usuário em um período
em metros.
REST
Nome
com.google.height.summary
Escopos de permissão do OAuth
https://www.googleapis.com/auth/fitness.body.read
Campos (format—units)
média (float - metros)
A altura média do usuário em um período, em metros.
max (float—metros)
A altura máxima do usuário em um período, em metros.
min (float - metros)
A altura mínima do usuário em um período, em metros.
Android
Nome
com.google.height.summary
Objeto de tipo de dados
AGGREGATE_HEIGHT_SUMMARY
Campos (format—units)
FIELD_AVERAGE (float - metros)
A altura média do usuário em um período, em metros.
FIELD_MAX (float - metros)
A altura máxima do usuário em um período, em metros.
FIELD_MIN (float - metros)
A altura mínima do usuário em um período, em metros.
Resumo do peso
Cada ponto de dados representa o peso médio, máximo e mínimo do usuário durante um
período, em quilogramas.
REST
Nome
com.google.weight.summary
Escopos de permissão do OAuth
https://www.googleapis.com/auth/fitness.body.read
Campos (format—units)
média (float kg)
O peso corporal médio do usuário em um período, em quilogramas.
max (float kg)
Peso corporal máximo do usuário em quilogramas em um período.
min (float kg)
Peso corporal mínimo do usuário em um período, em quilogramas.
Android
Nome
com.google.weight.summary
Objeto de tipo de dados
AGGREGATE_WEIGHT_SUMMARY
Campos (format—units)
FIELD_AVERAGE (float - kg)
O peso corporal médio do usuário em um período, em quilogramas.
FIELD_MAX (float - kg)
Peso corporal máximo do usuário em quilogramas em um período.
FIELD_MIN (float kg)
Peso corporal mínimo do usuário em um período, em quilogramas.
Local
Use esses tipos de dados para ler dados de local agregados.
Delta de distância
Cada ponto de dados representa a distância total do usuário percorrida em um período, em metros. Esse tipo de dados e os campos dele são os mesmos do
tipo de dados instantâneos.
Caixa delimitadora de local
Cada ponto de dados representa a caixa
delimitadora calculada nos pontos de localização
do usuário durante um período. Cada caixa tem quatro campos que representam os quatro cantos dela.
A velocidade média do usuário durante um período, em metros por segundo.
max (float: metros por segundo)
A velocidade máxima do usuário em um período, em metros por segundo.
min (float: metros por segundo)
A velocidade mínima do usuário em um período, em metros por segundo.
Android
Nome
com.google.speed.summary
Objeto de tipo de dados
AGGREGATE_SPEED_SUMMARY
Campos (format—units)
média (float — metros por segundo)
A velocidade média do usuário durante um período, em metros por segundo.
max (float: metros por segundo)
A velocidade máxima do usuário em um período, em metros por segundo.
min (float: metros por segundo)
A velocidade mínima do usuário em um período, em metros por segundo.
Nutrição
Use esses tipos de dados para ler dados de nutrição agregados.
Resumo da hidratação
Cada ponto de dados representa o volume total de água consumido por um usuário durante um
período, em litros. Esse tipo de dados e os campos dele são os mesmos do
tipo de dados instantâneos.
Resumo nutricional
Cada ponto de dados representa a soma de todas as entradas de nutrição ao longo de um período de tempo.
No campo de nutrientes, cada valor representa a soma do nutriente em todas
as entradas no período.
Se o nutriente não estiver em nenhuma das entradas, ele também não estará no mapa agregado. Se todas as entradas no período forem para a mesma refeição, o tipo de refeição também
será definido.
O total de nutrientes nos alimentos consumidos em um determinado período.
Valores aceitos
"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
Objeto de tipo de dados
AGGREGATE_NUTRITION_SUMMARY
Campos (format—units)
FIELD_MEAL_TYPE (int: enumeração)
O tipo de refeição que o usuário comeu (presente se todas as entradas no período forem para a mesma refeição).
O total de nutrientes nos alimentos consumidos em um determinado período.
Valores aceitos
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
Saúde
Use esses tipos de dados para ler dados agregados de saúde e de saúde.
Resumo da glicemia
Cada ponto de dados representa a média, mínima e máxima do nível de glicose no sangue
ou a concentração durante o intervalo de tempo, medido em mmol/L, em que 1 mmol/L representa 18
mg/dL.
Se os valores de cada um desses campos forem os mesmos para todas as medições realizadas durante o período, você verá o valor do campo nos dados retornados:
relação temporal a uma refeição
relação temporal com o sono
origem do espécime
Se os valores forem diferentes nas medições, o campo será excluído.
O nível médio de glicose no sangue ou a concentração do usuário durante um período.
max (float - mmol/L)
O nível máximo de glicose ou concentração do usuário durante um período.
min (float—mmol/L)
O nível mínimo de glicemia ou concentração do usuário durante um período.
relação temporal à refeição (int: enumeração) (campo opcional)
Quando a leitura foi feita em comparação com quando o usuário comeu.
Valores aceitos
"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 opcional)
Que tipo de refeição o usuário comeu quando a leitura foi feita.
relação temporal com o sono (int: enumeração) (campo opcional)
Quando a leitura foi feita em comparação com o momento em que o usuário dormiu.
Valores aceitos
"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
specimen source (int: enum) (campo opcional)
Tipo de fluido corporal usado para medir a glicose no sangue.
Quando a leitura foi feita em comparação com quando o usuário comeu.
Valores aceitos
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
Quando a leitura foi feita em comparação com o momento em que o usuário dormiu.
Valores aceitos
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.
Cada ponto de dados representa a pressão arterial média, mínima e máxima ao longo
do período, medida em mmHg.
Se os valores de cada um desses campos forem os mesmos para todas as medições realizadas durante o período, você verá o valor do campo nos dados retornados:
posição do corpo
local da medição
Se os valores forem diferentes nas medições, o campo será excluído.
A posição do corpo do usuário quando a medição foi realizada.
Valores aceitos
BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining
Em qual braço e parte do braço a medição foi realizada.
Valores aceitos
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
Resumo de temperatura corporal
Cada ponto de dados representa a temperatura corporal média, mínima e máxima do
usuário durante um período.
Ela também vai mostrar o local em que a medição foi feita no corpo, se
o local da medição for o mesmo em todos os pontos de dados no intervalo de tempo.
Cada ponto de dados representa a média, mínima e máxima de saturação de oxigênio no sangue
e a taxa de fluxo de oxigênio suplementar do usuário em um intervalo de tempo.
Se os valores de cada um desses campos forem os mesmos para todas as medições realizadas durante o período, você verá o valor do campo nos dados retornados:
modo de administração de oxigenoterapia
sistema de saturação de oxigênio
método de medição da saturação de oxigênio
Se os valores forem diferentes nas medições, o campo será excluído.
