Агрегированные типы данных

Для данных, которые можно записывать непрерывно (с несколькими точками данных за определенный период времени), платформа Google Fit может агрегировать эти данные и возвращать рассчитанные результаты. Это может быть среднее значение или итоговое значение. Вы можете сэкономить время на этих расчетах и ​​легко показать пользователям вашего приложения полезные сводки или средние значения, читая агрегированные данные.

Чтобы прочитать агрегированные данные, вам нужно выбрать тип данных, временной диапазон и что-то, по чему можно «сгруппировать» (или сгруппировать) данные. Вы можете группировать данные несколькими способами:

Период времени

Сгруппируйте агрегированные данные по часам или дням. Например, посмотрите шаги или калории, сожженные за день.

Тип деятельности

Сгруппируйте агрегированные данные по типам действий. Например, для данных о сне за неделю будет отдельный сегмент для каждого типа активности сна (легкий, глубокий и быстрый).

Сегмент активности

Сгруппируйте агрегированные данные по сегментам активности за период времени. Например, если пользователь отправился на пробежку с 9 до 10 утра, но бегал первые 20 минут, сидел 10 минут, гулял 15 минут и бегал 15 минут, это считается 4 сегментами активности и вернет 4 сегмента.

Сессия

Используйте временные границы сеансов для агрегирования данных. Например, если пользователь совершил 2 пробежки, которые были зарегистрированы как 2 сеанса (утренняя пробежка и дневная пробежка), вы можете сегментировать сеансы, чтобы узнать среднее количество шагов или среднюю скорость каждого пробега.

Активность

Используйте эти типы данных для чтения агрегированных данных о здоровье и самочувствии.

Сводка активности

Общее время и количество сегментов для определенного действия за период времени. Каждая точка данных представляет собой сводку всех сегментов активности для определенного типа активности за определенный интервал времени.

Сводная информация о базальном уровне метаболизма (BMR)

Каждая точка данных представляет собой среднюю, максимальную и минимальную скорость основного обмена пользователя за определенный период времени в килокалориях в день. Это полезно, если пользователь набрал или похудел в весе и, следовательно, его BMR изменился.

Сводка сожженных калорий

Совокупное или общее количество сожженных калорий в килокалориях за определенный период времени. Этот тип данных и его поля такие же, как и для мгновенного типа данных .

Сводка баллов кардиотренировок

Каждая точка данных представляет количество баллов кардиотренировок, заработанных за период времени.

Сводка минут перемещения

Общее количество минут хода за период времени. Этот тип данных и поля такие же, как и для мгновенного типа данных .

Обзор мощности

Каждая точка данных представляет собой среднюю, максимальную и минимальную мощность, вырабатываемую пользователем в ваттах за определенный период времени.

Сводка по разнице в количестве шагов

Каждая точка данных представляет общее количество шагов за период времени. Этот тип данных и его поля такие же, как и для мгновенного типа данных .

Тело

Используйте эти типы данных для чтения агрегированных данных об измерениях тела.

Сводка по процентному содержанию жира в организме

Каждая точка данных представляет собой средний, максимальный и минимальный процент жира в организме пользователя за определенный период времени.

Сводка сердечного ритма

Каждая точка данных представляет собой среднюю, максимальную и минимальную частоту пульса пользователя за период времени в ударах в минуту.

Сводка по высоте

Каждая точка данных представляет собой средний, максимальный и минимальный рост пользователя за период времени в метрах.

Сводка по весу

Каждая точка данных представляет собой средний, максимальный и минимальный вес пользователя за период времени в килограммах.

Расположение

Используйте эти типы данных для чтения агрегированных данных о местоположении.

Дельта расстояния

Каждая точка данных представляет общее расстояние, пройденное пользователем за период времени, в метрах. Этот тип данных и его поля такие же, как и для мгновенного типа данных .

Ограничительная рамка местоположения

Каждая точка данных представляет собой ограничивающую рамку , рассчитанную для точек местоположения пользователя за определенный период времени. Каждая ограничивающая рамка имеет четыре поля, представляющие четыре угла ограничивающей рамки.

Сводка скорости

Каждая точка данных представляет среднюю, максимальную и минимальную скорость, с которой пользователь проезжал за определенный период времени, в метрах в секунду.

Питание

Используйте эти типы данных для чтения агрегированных данных о питании.

Обзор гидратации

Каждая точка данных представляет общий объем воды, потребленный пользователем за период времени, в литрах. Этот тип данных и его поля такие же, как и для мгновенного типа данных .

Краткое описание питания

Каждая точка данных представляет собой сумму всех записей о питании за определенный период времени. В поле питательных веществ каждое значение представляет собой сумму питательных веществ по всем записям за период времени.

Если питательное вещество не было ни в одной из записей, его не будет и в сводной карте. Если все записи за период времени относятся к одному и тому же приему пищи, также будет установлен тип приема пищи.

"intVal": 1 // Unknown
"intVal": 2 // Breakfast
"intVal": 3 // Lunch
"intVal": 4 // Dinner
"intVal": 5 // Snack

"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

MEAL_TYPE_UNKNOWN // Unknown
MEAL_TYPE_BREAKFAST // Breakfast
MEAL_TYPE_LUNCH // Lunch
MEAL_TYPE_DINNER // Dinner
MEAL_TYPE_SNACK // Snack

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 мг/дл.

Если значения каждого из этих полей одинаковы для всех измерений, выполненных в течение временного диапазона, вы увидите значение поля в возвращаемых данных:

• временная связь с едой
• временная связь со сном
• источник образца

Если значения в разных измерениях различаются, поле будет исключено.

"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

"intVal": 1 // Unknown
"intVal": 2 // Breakfast
"intVal": 3 // Lunch
"intVal": 4 // Dinner
"intVal": 5 // Snack

"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

"intVal": 1 // Interstitial fluid
"intVal": 2 // Capillary blood
"intVal": 3 // Plasma
"intVal": 4 // Serum
"intVal": 5 // Tears
"intVal": 6 // Whole blood

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

MEAL_TYPE_UNKNOWN // Unknown
MEAL_TYPE_BREAKFAST // Breakfast
MEAL_TYPE_LUNCH // Lunch
MEAL_TYPE_DINNER // Dinner
MEAL_TYPE_SNACK // Snack

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.

BLOOD_GLUCOSE_SPECIMEN_SOURCE_INTERSTITIAL_FLUID // Interstitial fluid
BLOOD_GLUCOSE_SPECIMEN_SOURCE_CAPILLARY_BLOOD // Capillary blood
BLOOD_GLUCOSE_SPECIMEN_SOURCE_PLASMA // Plasma
BLOOD_GLUCOSE_SPECIMEN_SOURCE_SERUM // Serum
BLOOD_GLUCOSE_SPECIMEN_SOURCE_TEARS // Tears
BLOOD_GLUCOSE_SPECIMEN_SOURCE_WHOLE_BLOOD // Whole blood

Сводка артериального давления

Каждая точка данных представляет собой среднее, минимальное и максимальное артериальное давление за определенный период времени, измеренное в мм рт. ст.

Если значения каждого из этих полей одинаковы для всех измерений, выполненных в течение временного диапазона, вы увидите значение поля в возвращаемых данных:

• положение тела
• место измерения

Если значения в разных измерениях различаются, поле будет исключено.

"intVal": 1 // Standing up
"intVal": 2 // Sitting down
"intVal": 3 // Lying down
"intVal": 4 // Reclining

"intVal": 1 // Left wrist
"intVal": 2 // Right wrist
"intVal": 3 // Left upper arm
"intVal": 4 // Right upper arm

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

Сводка температуры тела

Каждая точка данных представляет собой среднюю, минимальную и максимальную температуру тела пользователя за определенный период времени.

Также будет указано место проведения измерения на теле, если место измерения было одинаковым для всех точек данных в интервале времени.

"intVal": 1 // Armpit
"intVal": 2 // Finger
"intVal": 3 // Forehead
"intVal": 4 // Mouth (oral)
"intVal": 5 // Rectum
"intVal": 6 // Temporal artery
"intVal": 7 // Toe
"intVal": 8 // Ear (tympanic)
"intVal": 9 // Wrist
"intVal": 10 // Vagina

BODY_TEMPERATURE_MEASUREMENT_LOCATION_AXILLARY // Armpit
BODY_TEMPERATURE_MEASUREMENT_LOCATION_FINGER // Finger
BODY_TEMPERATURE_MEASUREMENT_LOCATION_FOREHEAD // Forehead
BODY_TEMPERATURE_MEASUREMENT_LOCATION_ORAL // Mouth (oral)
BODY_TEMPERATURE_MEASUREMENT_LOCATION_RECTAL // Rectum
BODY_TEMPERATURE_MEASUREMENT_LOCATION_TEMPORAL_ARTERY // Temporal artery
BODY_TEMPERATURE_MEASUREMENT_LOCATION_TOE // Toe
BODY_TEMPERATURE_MEASUREMENT_LOCATION_TYMPANIC // Ear (tympanic
BODY_TEMPERATURE_MEASUREMENT_LOCATION_WRIST // Wrist
BODY_TEMPERATURE_MEASUREMENT_LOCATION_VAGINAL // Vagina

Сводная информация о насыщении кислородом

Каждая точка данных представляет собой среднее, минимальное и максимальное насыщение крови кислородом и скорость дополнительного потока кислорода пользователя за определенный интервал времени.

Если значения каждого из этих полей одинаковы для всех измерений, выполненных в течение временного диапазона, вы увидите значение поля в возвращаемых данных:

• режим проведения кислородной терапии
• система насыщения кислородом
• метод измерения насыщения кислородом

Если значения в разных измерениях различаются, поле будет исключено.