Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Для данных, которые можно записывать непрерывно (с несколькими точками данных за период времени), платформа Google Fit может агрегировать эти данные и возвращать рассчитанные результаты. Это может быть среднее значение или сводка/итог. Вы можете сэкономить время на этих вычислениях и легко показать пользователям вашего приложения полезные сводки или средние значения, прочитав агрегированные данные.
Чтобы прочитать агрегированные данные, вам нужно выбрать тип данных, временной диапазон и что-то, по чему можно «распределить» (или сгруппировать) данные. Вы можете разделить данные несколькими способами:
Временной период
Сегментные агрегированные данные по часам или дням. Например, посмотреть шаги или сожженные калории за день.
Тип деятельности
Сегментированные агрегированные данные по типу активности. Например, для данных о сне за неделю будет свой сегмент для каждого типа сна (легкий, глубокий и быстрый).
Сегмент активности
Сегмент агрегировал данные по сегментам активности за период времени. Например, если пользователь отправился на пробежку с 9 до 10 утра, но бегал первые 20 минут, сидел в течение 10 минут, шел в течение 15 минут и бегал в течение 15 минут, это считается 4 сегментами активности и возвращает 4 сегмента.
Сессия
Используйте временные границы сеансов для агрегирования данных. Например, если пользователь совершил 2 пробежки, которые были зарегистрированы как 2 сессии (утренняя пробежка и дневная пробежка), вы можете разделить по сеансам, чтобы узнать среднее количество шагов или среднюю скорость каждой пробежки.
Мероприятия
Используйте эти типы данных для чтения сводных данных о здоровье и самочувствии.
Сводка действий
Общее время и количество сегментов для определенного действия за период времени. Каждая точка данных представляет собой сводку всех сегментов активности для определенного типа активности за определенный интервал времени.
Общее время, потраченное на действие во всех сегментах временного диапазона.
FIELD_NUM_SEGMENTS ( int —количество)
Количество отдельных сегментов активности за временной интервал этой точки данных.
Сводка скорости основного обмена (BMR)
Каждая точка данных представляет собой среднюю, максимальную и минимальную скорость основного метаболизма пользователя за определенный период времени в килокалориях в день. Это полезно, если пользователь набрал или похудел, и поэтому его BMR изменился.
Минимальный BMR пользователя за определенный период времени.
Андроид
Имя
com.google.calories.bmr.summary
Объект типа данных
AGGREGATE_BASAL_METABOLIC_RATE_SUMMARY
Поля (формат — единицы измерения)
FIELD_AVERAGE ( float — ккал в день)
Средний BMR пользователя за период времени.
FIELD_MAX ( float — ккал в день)
Максимальный BMR пользователя за период времени.
FIELD_MIN ( float — ккал в день)
Минимальный BMR пользователя за определенный период времени.
Итог сожженных калорий
Совокупное или общее количество сожженных калорий в килокалориях за определенный период времени. Этот тип данных и его поля такие же, как и для мгновенного типа данных .
Сводка баллов кардиотренировок
Каждая точка данных представляет собой количество баллов кардиотренировок, заработанных за определенный период времени.
Количество баллов кардиотренировок, заработанных за определенный период времени, включая баллы, полученные с помощью множителей (больше баллов за более напряженную деятельность).
продолжительность ( float —минуты)
Время, за которое были заработаны баллы кардиотренировок, измеряется в минутах.
Андроид
Имя
com.google.heart_minutes.summary
Объект типа данных
AGGREGATE_HEART_POINTS
Поля (формат — единицы измерения)
FIELD_INTENSITY ( float — баллы кардиотренировок)
Количество баллов кардиотренировок, заработанных за определенный период времени, включая баллы, полученные с помощью множителей (больше баллов за более напряженную деятельность).
FIELD_DURATION ( float —минуты)
Время, за которое были заработаны баллы кардиотренировок, измеряется в минутах.
Сводка минут движения
Общее количество минут перемещения за период времени. Этот тип данных и поля такие же, как и для мгновенного типа данных .
Резюме мощности
Каждая точка данных представляет собой среднюю, максимальную и минимальную мощность, генерируемую пользователем в ваттах за определенный период времени.
Средняя мощность, вырабатываемая пользователем за период времени, в ваттах.
max ( float — ватты)
Максимальная мощность, выработанная пользователем за период времени, в ваттах.
min ( float — ватты)
Минимальная мощность, вырабатываемая пользователем за период времени, в ваттах.
Андроид
Имя
com.google.power.summary
Объект типа данных
AGGREGATE_POWER_SUMMARY
Поля (формат — единицы измерения)
FIELD_AVERAGE ( float —ватты)
Средняя мощность, вырабатываемая пользователем за период времени, в ваттах.
FIELD_MAX ( float —ватты)
Максимальная мощность, выработанная пользователем за период времени, в ваттах.
FIELD_MIN ( float —ватты)
Минимальная мощность, вырабатываемая пользователем за период времени, в ваттах.
Сводка дельты подсчета шагов
Каждая точка данных представляет собой общее количество шагов за период времени. Этот тип данных и его поля такие же, как и для мгновенного типа данных .
Тело
Используйте эти типы данных для чтения агрегированных данных измерений тела.
Сводка процентного содержания жира в организме
Каждая точка данных представляет средний, максимальный и минимальный процент жира в теле пользователя за определенный период времени.
ОТДЫХАТЬ
Имя
com.google.body.fat.percentage.summary
Области разрешений OAuth
https://www.googleapis.com/auth/fitness.body.read
Поля (формат — единицы измерения)
среднее ( float —процент)
Средний процент жира в общей массе тела пользователя за определенный период времени.
max ( float —процент)
Максимальный процент жировых отложений от общей массы тела пользователя за определенный период времени.
мин ( с float — процент)
Минимальный процент жировых отложений от общей массы тела пользователя за определенный период времени.
Андроид
Имя
com.google.body.fat.percentage.summary
Объект типа данных
AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
Поля (формат — единицы измерения)
FIELD_AVERAGE ( float —процент)
Средний процент жира в общей массе тела пользователя за определенный период времени.
FIELD_MAX ( float —процент)
Максимальный процент жировых отложений от общей массы тела пользователя за определенный период времени.
FIELD_MIN ( float —процент)
Минимальный процент жировых отложений от общей массы тела пользователя за определенный период времени.
Сводная информация о частоте сердечных сокращений
Каждая точка данных представляет среднюю, максимальную и минимальную частоту сердечных сокращений пользователя за период времени в ударах в минуту.
ОТДЫХАТЬ
Имя
com.google.heart_rate.summary
Области разрешений OAuth
https://www.googleapis.com/auth/fitness.body.read
Поля (формат — единицы измерения)
среднее ( с float — ударов в минуту)
Средняя частота сердечных сокращений пользователя в ударах в минуту за определенный период времени.
макс ( с float — ударов в минуту)
Максимальная частота сердечных сокращений пользователя в ударах в минуту за определенный период времени.
мин (с float — ударов в минуту)
Минимальная частота сердечных сокращений пользователя в ударах в минуту за определенный период времени.
Андроид
Имя
com.google.heart_rate.summary
Объект типа данных
AGGREGATE_HEART_RATE_SUMMARY
Поля (формат — единицы измерения)
FIELD_AVERAGE ( с float — ударов в минуту)
Средняя частота сердечных сокращений пользователя в ударах в минуту за определенный период времени.
FIELD_MAX ( с float — ударов в минуту)
Максимальная частота сердечных сокращений пользователя в ударах в минуту за определенный период времени.
FIELD_MIN ( с float — ударов в минуту)
Минимальная частота сердечных сокращений пользователя в ударах в минуту за определенный период времени.
Сводка по высоте
Каждая точка данных представляет средний, максимальный и минимальный рост пользователя за определенный период времени в метрах.
ОТДЫХАТЬ
Имя
com.google.height.summary
Области разрешений OAuth
https://www.googleapis.com/auth/fitness.body.read
Поля (формат — единицы измерения)
среднее ( float —метры)
Средний рост пользователя за определенный период времени в метрах.
max ( float —метры)
Максимальный рост пользователя за период времени в метрах.
min ( float —метры)
Минимальный рост пользователя за период времени в метрах.
Андроид
Имя
com.google.height.summary
Объект типа данных
AGGREGATE_HEIGHT_SUMMARY
Поля (формат — единицы измерения)
FIELD_AVERAGE ( float —метры)
Средний рост пользователя за определенный период времени в метрах.
FIELD_MAX ( float —метры)
Максимальный рост пользователя за период времени в метрах.
FIELD_MIN ( float —метры)
Минимальный рост пользователя за период времени в метрах.
Сводка по весу
Каждая точка данных представляет собой средний, максимальный и минимальный вес пользователя за определенный период времени в килограммах.
ОТДЫХАТЬ
Имя
com.google.weight.summary
Области разрешений OAuth
https://www.googleapis.com/auth/fitness.body.read
Поля (формат — единицы измерения)
средний ( float — кг)
Средняя масса тела пользователя за определенный период времени в килограммах.
max ( float — кг)
Максимальный вес тела пользователя за определенный период времени в килограммах.
мин ( float —кг)
Минимальная масса тела пользователя за определенный период времени в килограммах.
Андроид
Имя
com.google.weight.summary
Объект типа данных
AGGREGATE_WEIGHT_SUMMARY
Поля (формат — единицы измерения)
FIELD_AVERAGE ( float —kg)
Средняя масса тела пользователя за определенный период времени в килограммах.
FIELD_MAX ( float — кг)
Максимальный вес тела пользователя за определенный период времени в килограммах.
FIELD_MIN ( float —kg)
Минимальная масса тела пользователя за определенный период времени в килограммах.
Расположение
Используйте эти типы данных для чтения агрегированных данных о местоположении.
Дельта расстояния
Каждая точка данных представляет собой общее расстояние, пройденное пользователем за определенный период времени, в метрах. Этот тип данных и его поля такие же, как и для мгновенного типа данных .
Граничная рамка местоположения
Каждая точка данных представляет собой ограничивающую рамку, рассчитанную по точкам местоположения пользователя за определенный период времени. Каждая ограничивающая рамка имеет четыре поля, представляющие четыре угла ограничивающей рамки.
Минимальная широта ограничивающей рамки, представленной в виде числа с плавающей запятой, в градусах.
малая долгота ( float —градусы)
Минимальная долгота ограничивающей рамки, представленной в виде числа с плавающей запятой, в градусах.
высокая широта ( float —градусы)
Максимальная широта ограничивающего прямоугольника, представленного в виде числа с плавающей запятой, в градусах.
высокая долгота ( float — градусы)
Максимальная долгота ограничивающего прямоугольника, представленного в виде числа с плавающей запятой, в градусах.
Андроид
Имя
com.google.location.bounding_box
Объект типа данных
AGGREGATE_LOCATION_BOUNDING_BOX
Поля (формат — единицы измерения)
FIELD_LOW_LATITUDE ( float — градусы)
Широта нижнего левого угла ограничивающей рамки, представленной в виде числа с плавающей запятой, в градусах.
FIELD_LOW_LONGITUDE ( float — градусы)
Долгота нижнего левого угла ограничивающей рамки, представленной в виде числа с плавающей запятой, в градусах.
FIELD_HIGH_LATITUDE ( float — градусы)
Широта верхнего правого угла ограничивающей рамки, представленной в виде числа с плавающей запятой, в градусах.
FIELD_HIGH_LONGITUDE ( float —градусы)
Долгота верхнего правого угла ограничивающей рамки, представленной в виде числа с плавающей запятой, в градусах.
Сводная информация о скорости
Каждая точка данных представляет собой среднюю, максимальную и минимальную скорость, с которой пользователь двигался за определенный период времени, в метрах в секунду.
Средняя скорость пользователя за период времени, в метрах в секунду.
max ( float —метры в секунду)
Максимальная скорость пользователя за определенный период времени в метрах в секунду.
min ( float —метры в секунду)
Минимальная скорость пользователя за определенный период времени в метрах в секунду.
Андроид
Имя
com.google.speed.summary
Объект типа данных
AGGREGATE_SPEED_SUMMARY
Поля (формат — единицы измерения)
среднее ( float —метры в секунду)
Средняя скорость пользователя за период времени, в метрах в секунду.
max ( float —метры в секунду)
Максимальная скорость пользователя за определенный период времени в метрах в секунду.
min ( float —метры в секунду)
Минимальная скорость пользователя за определенный период времени в метрах в секунду.
Питание
Используйте эти типы данных для чтения агрегированных данных о питании.
Резюме гидратации
Каждая точка данных представляет собой общий объем воды, потребленный пользователем за определенный период времени, в литрах. Этот тип данных и его поля такие же, как и для мгновенного типа данных .
Резюме по питанию
Каждая точка данных представляет собой сумму всех записей о питании за определенный период времени. В поле питательных веществ каждое значение представляет собой сумму питательных веществ по всем записям за период времени.
Если питательного вещества не было ни в одной из записей, его не будет и на совокупной карте. Если все записи в период времени относятся к одному и тому же приему пищи, также будет установлен тип приема пищи.
питательные вещества ( Map<String> — калории/граммы)
Общее количество питательных веществ в пище, съеденной за определенный период времени.
Допустимые значения
"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
Андроид
Имя
com.google.nutrition.summary
Объект типа данных
AGGREGATE_NUTRITION_SUMMARY
Поля (формат — единицы измерения)
FIELD_MEAL_TYPE ( int —enum)
Какую еду ел пользователь (присутствует, если все записи за период времени относятся к одной и той же еде).
Общее количество питательных веществ в пище, съеденной за определенный период времени.
Допустимые значения
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
Здоровье
Используйте эти типы данных для чтения агрегированных медицинских данных и данных о состоянии здоровья.
Сводка уровня глюкозы в крови
Каждая точка данных представляет собой средний, минимальный и максимальный уровень или концентрацию глюкозы в крови за определенный период времени, измеренный в ммоль/л, где 1 ммоль/л равен 18 мг/дл.
Если значения для каждого из этих полей одинаковы для всех измерений, выполненных в течение временного диапазона, вы увидите значение поля в возвращаемых данных:
временное отношение к еде
временная связь со сном
источник образца
Если значения различаются по измерениям, поле будет исключено.
Средний уровень или концентрация глюкозы в крови пользователя за определенный период времени.
max ( float — ммоль/л)
Максимальный уровень или концентрация глюкозы в крови пользователя за определенный период времени.
min ( float — ммоль/л)
Минимальный уровень или концентрация глюкозы в крови пользователя за определенный период времени.
временная связь с едой ( int —enum) (необязательное поле)
Когда было снято показание, по сравнению с тем, когда пользователь ел.
Допустимые значения
"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
временная связь со сном ( int —enum) (необязательное поле)
Время, когда было снято показание, по сравнению со временем, когда пользователь спал.
Допустимые значения
"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
источник образца ( int —enum) (необязательное поле)
Тип жидкости организма, используемый для измерения уровня глюкозы в крови.
Средний уровень или концентрация глюкозы в крови пользователя за определенный период времени.
FIELD_MAX ( float — ммоль/л)
Максимальный уровень или концентрация глюкозы в крови пользователя за определенный период времени.
FIELD_MIN ( float — ммоль/л)
Минимальный уровень или концентрация глюкозы в крови пользователя за определенный период времени.
FIELD_TEMPORAL_RELATION_TO_MEAL ( int —enum) (необязательное поле)
Когда было снято показание, по сравнению с тем, когда пользователь ел.
Допустимые значения
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) (необязательное поле)
FIELD_TEMPORAL_RELATION_TO_SLEEP ( int —enum) (необязательное поле)
Время, когда было снято показание, по сравнению со временем, когда пользователь спал.
Допустимые значения
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.
FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE ( int —enum) (необязательное поле)
Тип жидкости организма, используемый для измерения уровня глюкозы в крови.
Каждая точка данных представляет собой среднее, минимальное и максимальное артериальное давление за определенный период времени, измеренное в мм рт.ст.
Если значения для каждого из этих полей одинаковы для всех измерений, выполненных в течение временного диапазона, вы увидите значение поля в возвращаемых данных:
положение тела
место измерения
Если значения различаются по измерениям, поле будет исключено.
Среднее диастолическое артериальное давление пользователя за определенный период времени.
FIELD_BLOOD_PRESSURE_DIASTOLIC_MAX ( float значение — мм рт. ст.)
Максимальное диастолическое артериальное давление пользователя за определенный период времени.
FIELD_BLOOD_PRESSURE_DIASTOLIC_MIN ( float — мм рт. ст.)
Минимальное диастолическое артериальное давление пользователя за определенный период времени.
FIELD_BODY_POSITION ( int —enum) (необязательное поле)
Положение тела пользователя во время измерения.
Допустимые значения
BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining
FIELD_BLOOD_PRESSURE_MEASUREMENT_LOCATION ( int —enum) (необязательное поле)
На какой руке и какой части руки производилось измерение.
Допустимые значения
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
Сводная информация о температуре тела
Каждая точка данных представляет собой среднюю, минимальную и максимальную температуру тела пользователя за определенный период времени.
Он также будет иметь место, где было выполнено измерение на теле, если место измерения было одним и тем же для всех точек данных в интервале времени.
Каждая точка данных представляет среднее, минимальное и максимальное насыщение крови кислородом и скорость дополнительного потока кислорода пользователя за определенный интервал времени.
Если значения для каждого из этих полей одинаковы для всех измерений, выполненных в течение временного диапазона, вы увидите значение поля в возвращаемых данных:
режим введения оксигенотерапии
система насыщения кислородом
метод измерения насыщения кислородом
Если значения различаются по измерениям, поле будет исключено.
