Typy danych dotyczące kalorii i energii

Interfejs Google Health API udostępnia typy danych, które śledzą kalorie i wydatek energetyczny użytkownika. Te typy mierzą różne aspekty spalania energii, w tym całkowity wydatek energetyczny, energię spaloną podczas aktywności i wskaźnik podstawowej przemiany materii.

Poznaj różnice między tymi typami danych, aby określić, które dane pasują do Twojej aplikacji.

Obsługiwane typy danych

Interfejs API obsługuje te typy danych do pomiaru kalorii i wydatku energetycznego:

Tabela: typy danych o kaloriach w interfejsie Google Health API

Typ danych   dataType   filter parametr	Typ rekordu	Dostępne operacje	Zakres	Obsługa webhooków	Obsługa prawdziwych zer
Energia spalona podczas aktywności   active-energy-burned   active_energy_burned	Interwał	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly
Wszystkie kalorie   total-calories   total_calories	Interwał	rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

W kolejnych sekcjach znajdziesz szczegóły techniczne dotyczące każdego typu danych, w tym przykłady reprezentacji REST i konkretne ograniczenia integracji.

Wszystkie kalorie

Wszystkie kalorie to pochodny typ danych tylko do odczytu, który śledzi całą energię wydatkowaną przez użytkownika, w tym podstawową przemianę materii i energię spaloną podczas aktywności, mierzoną w kilokaloriach (kcal). Wartość jest obliczana na podstawie wydatku energetycznego podczas aktywności i wskaźnika podstawowej przemiany materii użytkownika.

Zapytania dotyczące typu danych total-calories muszą zawierać filtr przedziału czasu (np. total_calories.interval.start_time lub total_calories.interval.civil_start_time). Maksymalny zakres tych zapytań to 14 dni.

Przykład zapytania

Aby wysłać zapytanie o typ danych total-calories, wyślij żądanie do punktu końcowego list z filtrem przedziału czasu:

Żądanie

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

Energia spalona podczas aktywności

Spalone kalorie podczas aktywności to energia spalona przez użytkownika w okresach aktywności, z wyłączeniem podstawowego wydatku energetycznego, mierzonego w kilokaloriach (kcal).

Przykład reprezentacji REST

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

Wytyczne

Podczas integrowania w aplikacji danych o kaloriach i energii postępuj zgodnie z tymi wytycznymi:

• Podsumowanie dzienne: aby wyświetlić ogólny dzienny wydatek energetyczny, poproś o dzienne podsumowanie typu danych total-calories.
• Wydatek energetyczny tylko podczas aktywności: aby śledzić kalorie spalone podczas konkretnego treningu lub w ciągu dnia z wyłączeniem wskaźnika podstawowej przemiany materii, wyślij zapytanie o active-energy-burned.