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 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   filter parameter	Jenis rekaman	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 Terbakar   basal-energy-burned   basal_energy_burned	Interval	list, reconcile	activity_and_fitness
Laju Metabolisme Basal   basal-metabolic-rate   basal_metabolic_rate	Contoh	list, reconcile	nutrition

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.

Catatan: 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 yang Terbakar

Energi Aktif yang 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
}

Energi Basal yang Terbakar

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

Catatan: Operasi rollup dan rollup harian tidak tersedia untuk jenis data ini. Untuk mendapatkan nilai energi basal harian, gunakan jenis data Laju Metabolisme Basal.

Laju Metabolisme Basal

Laju Metabolisme Basal mengukur energi yang dikeluarkan oleh tubuh dalam keadaan istirahat normal, yang diukur dalam kilokalori per hari (kcal/day). Karena laju ini berfluktuasi dengan pembaruan fisik (seperti berat badan) dari waktu ke waktu, 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 dibakar.

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 pengeluaran kalori harian secara keseluruhan, minta rollup harian jenis data total-calories.
• Pengeluaran khusus aktivitas: Untuk melacak kalori yang dibakar selama olahraga tertentu atau sepanjang hari, tidak termasuk laju metabolisme istirahat, kueri active-energy-burned.
• Metrik basal: Untuk melacak laju metabolisme istirahat atau tren metabolisme basal, kueri basal-metabolic-rate untuk nilai BMR. Perlakukan sampel BMR sebagai dasar harian untuk konsumsi energi istirahat pengguna.