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
Energia spalona w spoczynku   basal-energy-burned   basal_energy_burned	Interwał	list, reconcile	activity_and_fitness
Wskaźnik podstawowej przemiany materii   basal-metabolic-rate   basal_metabolic_rate	Przykład	list, reconcile	nutrition

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

Łączna liczba spalonych kalorii

Łączna liczba spalonych kalorii 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.

Energia spalona podczas aktywności

Aktywne spalone kalorie to energia spalona przez użytkownika w okresach aktywności, z wyłączeniem podstawowego wydatku energetycznego, mierzona 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
}

Energia spalona w spoczynku

Energia spalona w spoczynku to kalorie spalone w wyniku podstawowej przemiany materii użytkownika w określonych odstępach czasu, mierzone w kilokaloriach (kcal).

Uwaga: w przypadku tego typu danych operacje rollup i daily rollup są niedostępne. Aby uzyskać dzienne wartości energii podstawowej, użyj typu danych Wskaźnik podstawowej przemiany materii.

Wskaźnik podstawowej przemiany materii

Wskaźnik podstawowej przemiany materii mierzy energię wydatkowaną przez organizm w normalnym stanie spoczynku, mierzoną w kilokaloriach na dzień (kcal/day). Ponieważ ten wskaźnik zmienia się z czasem w zależności od zmian fizycznych (np. wagi), interfejs API rejestruje wskaźnik podstawowej przemiany materii jako szereg czasowy próbek wskaźnika.

Deweloperzy mogą traktować pole rateKcalPerDay w próbce basal-metabolic-rate jako odpowiednik dziennego podsumowania spalonych kalorii w spoczynku.

Przykład reprezentacji REST

{
  "date": {
    "year": 2026,
    "month": 4,
    "day": 20
  },
  "dataSource": { ... },
  "rateKcalPerDay": 1650.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 podstawowej przemiany materii, wyślij zapytanie o active-energy-burned.
• Dane podstawowe: aby śledzić podstawową przemianę materii lub trendy podstawowej przemiany materii, wyślij zapytanie o basal-metabolic-rate w celu uzyskania wartości wskaźnika podstawowej przemiany materii. Próbki wskaźnika podstawowej przemiany materii traktuj jako dzienną wartość bazową zużycia energii w spoczynku.