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 do tempo)
período), a plataforma Google Fit poderá agregar esses dados e retornar os
resultados calculados. Pode ser uma medida média ou um resumo/total. Você
pode economizar tempo nesses cálculos e mostrar aos usuários do aplicativo resumos úteis ou
calcula a média facilmente lendo os dados agregados.
Para ler dados agregados, você precisa escolher um tipo de dados, um período e algo assim
para "bucket" (ou agrupar) os dados. É possível agrupar dados de algumas maneiras diferentes:
Período
Bucket de dados agregados por hora ou por dia. Por exemplo, veja passos ou calorias queimadas por dia.
Tipo de atividade
Bucket agregados por tipo de atividade. Por exemplo, para dados de sono ao longo de uma semana, haverá um intervalo para cada tipo de atividade de sono (leve, profundo e REM).
Segmento de atividade
Agrupe dados agregados por segmentos de atividade ao longo de um período. Por exemplo, se um usuário saiu para correr entre 9h e 10h, mas correu pelos primeiros 20 minutos, sentou-se por 10 minutos, caminhou 15 minutos e correu por 15 minutos, isso seria considerado 4 segmentos de atividade e retornaria 4 intervalos.
Sessão
Use os limites de tempo das sessões para agregar dados. Por exemplo, se um usuário fez duas corridas registradas como duas (uma de manhã e outra de tarde), você pode agrupar por sessão para saber os 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 para uma atividade específica em um período.
Cada ponto de dados representa um resumo de todos os segmentos de atividade de um determinado
o tipo de atividade em um intervalo de tempo.
O tipo de atividade que o usuário estava realizando. Confira a lista de tipos de atividade aqui.
duration (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 (formato — unidades)
FIELD_ACTIVITY (int—enum)
O tipo de atividade que o usuário estava realizando. Confira 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 de metabolismo basal basal média, máxima e mínima do usuário
no intervalo de tempo, em quilocalorias por dia. Isso é útil se o usuário tiver
ganhou ou perdeu peso e, portanto, sua TMB mudou.
O valor agregado ou total de calorias queimadas, em quilocalorias, ao longo de um período.
Esse tipo de dados e os campos são os mesmos dos dados instantâneos
tipo.
Resumo dos Pontos cardio
Cada ponto de dados representa o número de Pontos cardio obtidos ao longo do período.
O número de Pontos cardio recebidos ao longo do período
incluindo os pontos ganhos por multiplicadores (mais pontos ganhos por
atividade mais intensa).
duration (float– minutos)
É o horário em que os Pontos cardio foram ganhos, medido em minutos.
Android
Nome
com.google.heart_minutes.summary
Objeto de tipo de dados
AGGREGATE_HEART_POINTS
Campos (formato — unidades)
FIELD_INTENSITY (float — Pontos cardio)
O número de Pontos cardio recebidos ao longo do período
incluindo os pontos ganhos por multiplicadores (mais pontos ganhos por
atividade mais intensa).
FIELD_DURATION (float minutos)
É o horário em que os Pontos cardio foram ganhos, medido em minutos.
Resumo dos Minutos em movimento
O número total de minutos em movimento no período. Esse tipo de dados e campos
são os mesmos do tipo de dados instantâneos.
Resumo da energia
Cada ponto de dados representa a potência média, máxima e mínima gerada pelo usuário em watts durante um período.
Energia média do usuário gerada ao longo do período em watts.
máx. (float—watts)
Potência máxima gerada pelo usuário no período em watts.
min (float—watts)
Energia mínima gerada do usuário no período em watts.
Android
Nome
com.google.power.summary
Objeto de tipo de dados
AGGREGATE_POWER_SUMMARY
Campos (formato — unidades)
FIELD_AVERAGE (float - watts)
Energia média do usuário gerada ao longo do período em watts.
FIELD_MAX (float - watts)
Potência máxima gerada pelo usuário no período em watts.
FIELD_MIN (float - watts)
Energia mínima gerada do usuário no período em watts.
Resumo delta da contagem de passos
Cada ponto de dados representa o número total de etapas no período.
Esse tipo de dados e os campos são os mesmos dos dados instantâneos
tipo.
Corpo
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édio, máximo e mínimo do usuário
ao longo de 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 (formato — unidades)
média (float — porcentagem)
Porcentagem média do usuário da massa corporal total que é de gordura corporal, ao longo de um período.
máx. (float — porcentagem)
A porcentagem máxima do usuário de massa corporal total que é de gordura corporal ao longo de um período.
min (float — porcentagem)
A porcentagem mínima do usuário da massa corporal total que é de 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 (formato — unidades)
FIELD_AVERAGE (float — porcentagem)
Porcentagem média do usuário da massa corporal total que é de gordura corporal, ao longo de um período.
FIELD_MAX (float — porcentagem)
A porcentagem máxima do usuário de massa corporal total que é de gordura corporal ao longo de um período.
FIELD_MIN (float — porcentagem)
A porcentagem mínima do usuário da massa corporal total que é de 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 ao longo do
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 (formato — unidades)
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, ao longo de um período.
min (float—bpm)
A frequência cardíaca mínima do usuário em batimentos por minuto, ao longo de um período.
Android
Nome
com.google.heart_rate.summary
Objeto de tipo de dados
AGGREGATE_HEART_RATE_SUMMARY
Campos (formato — unidades)
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, ao longo de um período.
FIELD_MIN (float—bpm)
A frequência cardíaca mínima do usuário em batimentos por minuto, ao longo de um período.
Resumo da altura
Cada ponto de dados representa a altura média, máxima e mínima do usuário ao longo de um período
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 (formato — unidades)
média (float — metros)
A altura média do usuário em um período em metros.
max (float — metros)
Altura máxima do usuário em um período, em metros.
min (float — metros)
Altura mínima do usuário ao longo de um período, em metros.
Android
Nome
com.google.height.summary
Objeto de tipo de dados
AGGREGATE_HEIGHT_SUMMARY
Campos (formato — unidades)
FIELD_AVERAGE (float — metros)
A altura média do usuário em um período em metros.
FIELD_MAX (float — metros)
Altura máxima do usuário em um período, em metros.
FIELD_MIN (float — metros)
Altura mínima do usuário ao longo de 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 em um
período de tempo, em quilogramas.
REST
Nome
com.google.weight.summary
Escopos de permissão do OAuth
https://www.googleapis.com/auth/fitness.body.read
Campos (formato — unidades)
média (float — kg)
É o peso médio do corpo do usuário em quilogramas durante um período.
máx. (float—kg)
Peso corporal máximo do usuário em quilogramas em um determinado período.
min (float—kg)
Peso corporal mínimo do usuário em quilogramas ao longo de um período.
Android
Nome
com.google.weight.summary
Objeto de tipo de dados
AGGREGATE_WEIGHT_SUMMARY
Campos (formato — unidades)
FIELD_AVERAGE (float—kg)
É o peso médio do corpo do usuário em quilogramas durante um período.
FIELD_MAX (float—kg)
Peso corporal máximo do usuário em quilogramas em um determinado período.
FIELD_MIN (float—kg)
Peso corporal mínimo do usuário em quilogramas ao longo de um período.
Local
Use-os para ler dados de local agregados.
Delta da distância
Cada ponto de dados representa a distância total percorrida pelo usuário em um período
período, em metros. Esse tipo de dados e seus campos são os mesmos que para o
tipo de dados instantâneos:
Caixa delimitadora de local
Cada ponto de dados representa o limite
computada com base no valor
pontos de localização em um período. Cada caixa delimitadora tem quatro campos.
que representam os quatro cantos da caixa delimitadora.
Velocidade média do usuário durante um período, em metros por segundo.
max (float — metros por segundo)
Velocidade máxima do usuário em um período, em metros por segundo.
min (float — metros por segundo)
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 (formato — unidades)
média (float — metros por segundo)
Velocidade média do usuário durante um período, em metros por segundo.
max (float — metros por segundo)
Velocidade máxima do usuário em um período, em metros por segundo.
min (float — metros por segundo)
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 de hidratação
Cada ponto de dados representa o volume total de água consumido por um usuário em um período
período, em litros. Esse tipo de dados e seus campos são os mesmos que para o
tipo de dados instantâneos:
Resumo nutricional
Cada ponto de dados representa a soma de todas as entradas nutricionais em um período.
No campo de nutrientes, cada valor representa a soma dos nutrientes em todo o
das entradas no período.
Se o nutriente não estiver em nenhuma das entradas, ele não estará no mapa agregado.
também Se todas as entradas no período forem para a mesma refeição, o tipo de refeição
também serão definidos.
Total de nutrientes do alimento consumido em um 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 (formato — unidades)
FIELD_MEAL_TYPE (int—enum)
O tipo de refeição que o usuário comeu (presente se todas as entradas no período forem para a mesma refeição).
Total de nutrientes do alimento consumido em um 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 médicos e de saúde agregados.
Resumo da glicose no sangue
Cada ponto de dados representa o nível médio, mínimo e máximo de glicose no sangue
ou concentração no período, medida em mmol/L, em que 1 mmol/L é 18
mg/dL.
Se os valores em 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 com uma refeição
relação temporal ao sono
fonte do espécime
Se os valores forem diferentes entre as medições, o campo será excluído.
Nível ou concentração médio de glicose no sangue do usuário em um período.
máx. (float—mmol/L)
Nível ou concentração máximo de glicose no sangue do usuário em um período.
min (float—mmol/L)
Nível ou concentração mínima de glicose no sangue do usuário em um período.
relação temporal com a refeição (int — enum) (campo opcional)
Data em que 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.
Data em que 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
FIELD_MEAL_TYPE (int — enum) (campo opcional)
Que tipo de refeição o usuário comeu quando a leitura foi feita.
Data de realização da leitura e período 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 as pressão média, mínima e máxima
ao intervalo de tempo, medido em mmHg.
Se os valores em 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 de medição
Se os valores forem diferentes entre as medições, o campo será excluído.
Pressão arterial diastólica média do usuário durante um período.
FIELD_BLOOD_PRESSURE_DIASTOLIC_MAX (float - mmHg)
Pressão arterial diastólica máxima do usuário em um período.
FIELD_BLOOD_PRESSURE_DIASTOLIC_MIN (float - mmHg)
Pressão arterial diastólica mínima do usuário ao longo de um período.
FIELD_BODY_POSITION (int — enum) (campo opcional)
A posição do corpo do usuário quando a medição foi feita.
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 grupo e parte dele 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 da temperatura corporal
Cada ponto de dados representa as temperaturas corporais médias, mínimas e máximas de
o usuário em determinado período.
Ele também terá o local onde a medição foi feita no corpo, se
o local de medição foi o mesmo para todos os pontos de dados no intervalo de tempo.
Cada ponto de dados representa as médias, mínimas e máximas de oxigênio no sangue
saturação e taxa de fluxo de oxigênio suplementar do usuário em um intervalo de tempo.
Se os valores em 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 da terapia de oxigênio
sistema de saturação de oxigênio
método de medição da saturação de oxigênio
Se os valores forem diferentes entre as medições, o campo será excluído.
[null,null,["Última atualização 2024-08-22 UTC."],[[["Google Fit aggregate data types provide summaries of health and fitness data over time."],["These data types are read-only and are categorized by Activity, Body, and Location."],["Aggregate data is accessed by specifying the data type, time range, and bucketing method."],["Data can be retrieved through REST APIs and Android, but field names may vary."],["Summaries for body temperature, blood pressure, and oxygen saturation are also available, including average, minimum, and maximum values."]]],[]]
