Datentypen für Kalorien und Energie

Die Google Health API bietet Datentypen, mit denen die Kalorien und der Energieverbrauch eines Nutzers erfasst werden. Diese Typen messen verschiedene Aspekte des Energieverbrauchs, einschließlich des Gesamtverbrauchs, des aktiven Verbrauchs und des Grundumsatzes.

Wenn Sie die Unterschiede zwischen diesen Datentypen kennen, können Sie die für Ihre Anwendung geeigneten Messwerte ermitteln.

Unterstützte Datentypen

Die API unterstützt die folgenden Datentypen zum Messen von Kalorien und Energieverbrauch:

Tabelle: Google Health API-Datentypen für Kalorien

Datentyp   dataType   filter-Parameter	Eintragstyp	Verfügbare Vorgänge	Umfang	Webhook- Support	Unterstützung für echte Nullen
Verbrannte aktive Kalorien   active-energy-burned   active_energy_burned	Intervall	list, reconcile, rollup, dailyRollup	activity_and_fitness
Durch Grundumsatz verbrauchte Kalorien   basal-energy-burned   basal_energy_burned	Intervall	list, reconcile	activity_and_fitness
Grundumsatz   basal-metabolic-rate   basal_metabolic_rate	Beispiel	list, reconcile	Ernährung

In den folgenden Abschnitten finden Sie technische Details zu den einzelnen Datentypen, einschließlich Beispielen für die REST-Darstellung und spezifischen Integrationsbeschränkungen.

Kalorien insgesamt

„Total Calories“ ist ein schreibgeschützter abgeleiteter Datentyp, der den gesamten Energieverbrauch eines Nutzers erfasst, einschließlich Grundumsatz und aktiver Energie, gemessen in Kilokalorien (kcal). Der Wert wird aus dem aktiven Energieverbrauch und dem Grundumsatz des Nutzers berechnet.

Durch Aktivität verbrauchte Kalorien

„Durch Aktivität verbrauchte Kalorien“ gibt den Energieverbrauch des Nutzers während Aktivitätsphasen an. Der Grundumsatz ist dabei nicht berücksichtigt. Die Einheit ist Kilokalorien (kcal).

Beispiel für die REST-Darstellung

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

Durch Grundumsatz verbrauchte Kalorien

Der Grundumsatz gibt die Kalorien an, die aufgrund des Stoffwechsels des Nutzers in Ruhe über Zeitintervalle hinweg verbrannt werden. Er wird in Kilokalorien (kcal) gemessen.

Hinweis:Sammel- und tägliche Sammelvorgänge sind für diesen Datentyp nicht verfügbar. Verwende den Datentyp „Grundumsatz“, um tägliche Werte für den Grundumsatz zu erhalten.

Grundumsatz

Der Grundumsatz (GU) gibt an, wie viel Energie ein Körper in einem normalen Ruhezustand verbraucht. Er wird in Kilokalorien pro Tag (kcal/day) gemessen. Da dieser Wert im Laufe der Zeit mit körperlichen Veränderungen (z. B. Gewicht) schwankt, wird der GU in der API als Zeitreihe von Ratenmessungen erfasst.

Entwickler können das Feld rateKcalPerDay in einem basal-metabolic-rate-Sample als tägliches Pendant zu einem täglichen Rollup der verbrannten Kalorien betrachten.

Beispiel für die REST-Darstellung

{
  "date": {
    "year": 2026,
    "month": 4,
    "day": 20
  },
  "dataSource": { ... },
  "rateKcalPerDay": 1650.0
}

Richtlinien

Wenn Sie Messwerte für Kalorien und Energie in Ihre App einbinden, beachten Sie die folgenden Richtlinien:

• Tagesübersicht:Wenn du den gesamten täglichen Kalorienverbrauch anzeigen möchtest, fordere die tägliche Zusammenfassung des Datentyps total-calories an.
• Kalorienverbrauch nur durch Aktivität:Wenn du den Kalorienverbrauch während eines bestimmten Trainings oder im Laufe des Tages ohne den Grundumsatz erfassen möchtest, frage active-energy-burned ab.
• Basale Messwerte:Wenn du den Grundumsatz oder Trends beim Grundumsatz erfassen möchtest, frage basal-metabolic-rate nach BMR-Werten ab. BMR-Messwerte gelten als täglicher Referenzwert für den Energieverbrauch im Ruhezustand des Nutzers.