Typy danych dotyczące kalorii i energii

Interfejs Google Health API udostępnia typy danych, które śledzą kalorie i wydatkowaną energię użytkownika. Mierzą one różne aspekty spalania energii, w tym całkowity wydatek energetyczny, spalanie podczas aktywności i spalanie w spoczynku (podstawową przemianę 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 dotyczące kalorii w interfejsie Google Health API

Typ danych   dataType   filter parameter	Record type	Dostępne operacje	Zakres	Webhook support	Obsługa wartości zerowych
Spalone kalorie podczas aktywności   active-energy-burned   active_energy_burned	Interwał	list, reconcile, rollup, dailyRollup	activity_and_fitness
Podstawowa przemiana materii – spalone kalorie   basal-energy-burned   basal_energy_burned	Interwał	lista, uzgadnianie	activity_and_fitness
Wskaźnik podstawowej przemiany materii   basal-metabolic-rate   basal_metabolic_rate	Przykład	lista, uzgadnianie	nutrition

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

Całkowita liczba kalorii to tylko do odczytu typ danych pochodnych, który śledzi całą energię wydatkowaną przez użytkownika, w tym podstawową przemianę materii i energię aktywną, mierzoną w kilokaloriach (kcal). Wartość jest obliczana na podstawie wydatku energetycznego związanego z 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ładowe zapytanie

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

Żą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. Są mierzone 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
}

Podstawowa przemiana materii – spalone kalorie

Spalone kalorie (PPM) to kalorie spalone w wyniku metabolizmu w spoczynku w określonych przedziałach czasu, mierzone w kilokaloriach (kcal).

Uwaga: operacje zbiorcze i zbiorcze dzienne nie są dostępne w przypadku tego typu danych. Aby uzyskać dzienne wartości podstawowego wydatku energetycznego, użyj typu danych Podstawowa przemiana materii.

Wskaźnik podstawowej przemiany materii

Wskaźnik podstawowej przemiany materii (BMR) mierzy energię wydatkowaną przez organizm w normalnym stanie spoczynku i jest wyrażany 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 basal-metabolic-rate próbce jako odpowiednik dziennego podsumowania spalonych kalorii podstawowych.

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 wskazówkami:

• Podsumowanie dzienne: aby wyświetlić ogólne dzienne wydatkowanie kalorii, poproś o dzienne podsumowanie typu danych total-calories.
• Wydatkowanie energii 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ć tempo przemiany materii w spoczynku lub trendy dotyczące podstawowej przemiany materii, wysyłaj zapytania do basal-metabolic-rate o wartości BMR. Traktuj próbki BMR jako dzienną wartość bazową spoczynkowego zużycia energii przez użytkownika.