Jenis data kalori dan energi

Google Health API menyediakan jenis data yang melacak kalori dan pengeluaran energi pengguna. Jenis ini mengukur berbagai aspek pembakaran energi, termasuk total pengeluaran, pembakaran aktif, dan laju metabolisme istirahat (basal).

Pahami perbedaan antara jenis data ini untuk menentukan metrik mana yang sesuai dengan aplikasi Anda.

Jenis data yang didukung

API mendukung jenis data berikut untuk mengukur kalori dan pengeluaran energi:

Tabel: Jenis data kalori Google Health API
Jenis data
  dataType Parameter
  filter		 Jenis
kumpulan data		 Operasi
yang tersedia		 Cakupan Dukungan
webhook		 Dukungan
nol sebenarnya
Energi Aktif yang Terbakar
  active-energy-burned
  active_energy_burned 		Interval list, reconcile, rollup, dailyRollup activity_and_fitness
Energi Basal yang Dibakar
  basal-energy-burned
  basal_energy_burned 		Interval list, reconcile activity_and_fitness
Laju Metabolisme Basal
  basal-metabolic-rate
  basal_metabolic_rate 		Contoh list, reconcile gizi

Bagian berikut memberikan detail teknis untuk setiap jenis data, termasuk contoh representasi REST dan batasan integrasi tertentu.

Total Kalori

Total Kalori adalah jenis data turunan hanya baca yang melacak semua energi yang dikeluarkan oleh pengguna, termasuk metabolisme basal dan energi aktif, yang diukur dalam kilokalori (kcal). Nilai ini dihitung dari pengeluaran energi aktif dan tingkat metabolisme basal pengguna.

Energi Aktif yang Dibakar

Energi Aktif yang Dibakar menunjukkan energi yang dibakar oleh pengguna selama periode aktivitas, tidak termasuk pengeluaran energi basal, yang diukur dalam kilokalori (kcal).

Contoh representasi REST

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

Energi Basal yang Dibakar

Energi Basal yang Dibakar mewakili kalori terbakar karena metabolisme istirahat pengguna selama interval waktu, diukur dalam kilokalori (kcal).

Catatan: Operasi penggabungan dan penggabungan harian tidak tersedia untuk jenis data ini. Untuk mendapatkan nilai energi basal harian, gunakan jenis data Basal Metabolic Rate.

Laju Metabolisme Basal

Laju Metabolisme Basal mengukur energi yang dikeluarkan oleh tubuh dalam keadaan istirahat normal, diukur dalam kilokalori per hari (kcal/day). Karena laju ini berfluktuasi seiring waktu dengan perubahan fisik (seperti berat badan), API mencatat BMR sebagai deret waktu sampel laju.

Developer dapat memperlakukan kolom rateKcalPerDay dalam sampel basal-metabolic-rate sebagai padanan harian untuk rollup harian energi basal yang terbakar.

Contoh representasi REST

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

Panduan

Saat mengintegrasikan metrik kalori dan energi di aplikasi Anda, gunakan panduan berikut:

  • Ringkasan harian: Untuk menampilkan total pembakaran kalori harian secara keseluruhan, minta ringkasan harian jenis data total-calories.
  • Pengeluaran khusus aktivitas: Untuk melacak kalori yang terbakar selama olahraga tertentu atau sepanjang hari, tidak termasuk laju metabolisme istirahat, kueri active-energy-burned.
  • Metrik basal: Untuk melacak tren laju metabolisme istirahat atau laju metabolisme basal, kueri basal-metabolic-rate untuk nilai BMR. Perlakukan sampel BMR sebagai dasar pengukuran harian untuk konsumsi energi istirahat pengguna.
Sebelumnya
Indeks jenis data