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

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

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

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

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

Таблица: Типы данных о калориях в Google Health API
Тип данных
dataType
параметр filter		 Записывать
тип		 Доступный
операции		 Объем Вебхук
поддерживать		 Истинные нули
поддерживать
Сожженная активная энергия
active-energy-burned
active_energy_burned		 Интервал список, сверка, свертка, ежедневная сводка активность_и_фитнес
Общее количество калорий
total-calories
total_calories		 Интервал rollup, dailyRollup активность_и_фитнес

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

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

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

Запросы к данным типа total-calories должны включать фильтр временного интервала (например, total_calories.interval.start_time или total_calories.interval.civil_start_time ). Максимальный диапазон для этих запросов составляет 14 дней.

Пример запроса

Для запроса данных типа total-calories отправьте запрос к конечной точке list с фильтром по интервалу:

Запрос 

GET https://health.googleapis.com/v4/users/me/dataTypes/total-calories/dataPoints?filter=total_calories.interval.start_time >= "2026-04-20T00:00:00Z" AND total_calories.interval.start_time < "2026-04-21T00:00:00Z"
Authorization: Bearer access-token
Accept: application/json

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

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

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

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

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

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

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