Калории и типы данных об энергии

API Google Health предоставляет типы данных, которые отслеживают потребление калорий и расход энергии пользователем. Эти типы измеряют различные аспекты расхода энергии, включая общий расход, активный расход и скорость метаболизма в состоянии покоя (базальный метаболизм).

Чтобы определить, какие метрики подходят для вашего приложения, необходимо понимать различия между этими типами данных.

Поддерживаемые типы данных

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

Таблица: Типы данных о калориях в Google Health API
Тип данных
dataType
параметр filter		 Записывать
тип		 Доступный
операции		 Объем Вебхук
поддерживать		 Истинные нули
поддерживать
Сожженная активная энергия
active-energy-burned
active_energy_burned		 Интервал список, сверка, свертка, ежедневная сводка активность_и_фитнес
Базовая энергия сожжена
basal-energy-burned
basal_energy_burned		 Интервал список, согласовать активность_и_фитнес
Базальный метаболизм
basal-metabolic-rate
basal_metabolic_rate		 Образец список, согласовать питание

В следующих разделах представлены технические подробности для каждого типа данных, включая примеры представления в REST-формате и конкретные ограничения интеграции.

Общее количество калорий

«Общее количество калорий» — это производный тип данных, доступный только для чтения, который отслеживает все энергетические затраты пользователя, включая основной обмен веществ и активную энергию, измеряемую в килокалориях ( kcal ). Значение рассчитывается на основе расхода активной энергии и основного обмена веществ пользователя.

Сожженная активная энергия

Показатель «Активное потребление энергии» отражает количество энергии, затраченной пользователем в периоды активности, за исключением его базовых энергетических затрат, измеряемое в килокалориях ( kcal ).

Пример представления REST 

{
  "startTime": "2026-04-20T08:00:00Z",
  "startUtcOffset": "0s",
  "endTime": "2026-04-20T08:30:00Z",
  "endUtcOffset": "0s",
  "dataSource": { ... },
  "kcal": 150.0
}

Базовая энергия сожжена

Показатель «базовая энергия, сожженная за счет метаболизма в состоянии покоя» представляет собой количество калорий, сожженных пользователем за определенные интервалы времени, измеряемое в килокалориях ( kcal ).

Примечание: Операции агрегирования и ежедневного агрегирования для этого типа данных недоступны. Для получения ежедневных значений базальной энергии используйте тип данных «Базальная скорость метаболизма».

Базальный метаболизм

Базальный метаболизм измеряет энергию, расходуемую организмом в нормальном состоянии покоя, в килокалориях в сутки ( kcal/day ). Поскольку этот показатель колеблется в зависимости от изменений физических параметров (таких как вес) с течением времени, API регистрирует БМР в виде временного ряда выборок показателей.

Разработчики могут рассматривать поле rateKcalPerDay в выборке basal-metabolic-rate как ежедневный аналог ежедневного суммарного количества сожженной базовой энергии.

Пример представления REST 

{
  "date": {
    "year": 2026,
    "month": 4,
    "day": 20
  },
  "dataSource": { ... },
  "rateKcalPerDay": 1650.0
}

Руководящие принципы

При интеграции показателей калорий и энергии в ваше приложение следуйте этим рекомендациям:

  • Ежедневный обзор: Чтобы отобразить общий суточный расход калорий, запросите ежедневный сводный отчет по типу данных total-calories .
  • Расход калорий только во время активности: Чтобы отслеживать количество сожженных калорий во время конкретной тренировки или в течение дня, исключая скорость метаболизма в состоянии покоя, выполните запрос active-energy-burned .
  • Базовые показатели: Для отслеживания скорости метаболизма в состоянии покоя или тенденций базального метаболизма запросите значения BMR у ресурса basal-metabolic-rate . Используйте данные BMR в качестве ежедневного базового уровня для оценки потребления энергии в состоянии покоя.
Назад
Индекс типов данных