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	żywienie

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 kalorii

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

Uwaga: 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 dotyczące typu 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

Energia spalona podczas aktywności 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 przedziałach 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 BMR jako szereg czasowy próbek wskaźnika.

Deweloperzy mogą traktować pole rateKcalPerDay w próbce basal-metabolic-rate jako odpowiednik dziennego podsumowania energii spalonej 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 active-energy-burned.
• Dane podstawowe: aby śledzić podstawową przemianę materii lub trendy podstawowej przemiany materii, wyślij zapytanie basal-metabolic-rate o wartości BMR. Próbki BMR traktuj jako dzienną wartość bazową zużycia energii w spoczynku przez użytkownika.