Jenis data kalori dan energi

Google Health API menyediakan jenis data yang melacak pengeluaran kalori dan 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 yang sesuai dengan aplikasi Anda.

Jenis data yang didukung

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

Tabel: Jenis data kalori Google Health API

Jenis data   dataType   filter parameter	Jenis rekaman	Operasi yang tersedia	Cakupan	Dukungan webhook	Dukungan nol sebenarnya
Energi Aktif Terbakar   active-energy-burned   active_energy_burned	Interval	list, reconcile, rollup, dailyRollup	activity_and_fitness
Total Kalori   total-calories   total_calories	Interval	rollup, dailyRollup	activity_and_fitness

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 laju metabolisme basal pengguna.

Kueri untuk jenis data total-calories harus menyertakan filter interval waktu (seperti total_calories.interval.start_time atau total_calories.interval.civil_start_time). Rentang maksimum untuk kueri ini adalah 14 hari.

Contoh kueri

Untuk mengkueri jenis data total-calories, kirim permintaan ke endpoint list dengan filter interval:

Permintaan

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

Energi Aktif Terbakar

Energi Aktif Terbakar mewakili 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
}

Panduan

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

• Ringkasan harian: Untuk menampilkan pengeluaran kalori harian secara keseluruhan, minta rollup harian jenis data total-calories.
• Pengeluaran khusus aktivitas: Untuk melacak pembakaran kalori selama latihan fisik tertentu atau sepanjang hari, tidak termasuk laju metabolisme istirahat, kueri active-energy-burned.