Kalori ve enerji veri türleri

Google Health API, kullanıcının kalori ve enerji harcamasını takip eden veri türleri sağlar. Bu türler, toplam harcama, aktif yakma ve dinlenme (bazal) metabolizma hızları dahil olmak üzere enerji yakımının farklı yönlerini ölçer.

Uygulamanıza hangi metriklerin uygun olduğunu belirlemek için bu veri türleri arasındaki farkları anlayın.

Desteklenen veri türleri

API, kalori ve enerji harcamasını ölçmek için aşağıdaki veri türlerini destekler:

Tablo: Google Health API kalori veri türleri

Veri türü   dataType   filter parametresi	Kayıt türü	Kullanılabilir işlemler	Kapsam	Webhook desteği	Gerçek sıfırlar desteği
Yakılan Aktif Enerji   active-energy-burned   active_energy_burned	Aralık	list, reconcile, rollup, dailyRollup	activity_and_fitness
Harcanan Bazal Enerji   basal-energy-burned   basal_energy_burned	Aralık	list, reconcile	activity_and_fitness
Bazal Metabolizma Hızı   basal-metabolic-rate   basal_metabolic_rate	Örnek	list, reconcile	nutrition

Aşağıdaki bölümlerde, REST gösterimi örnekleri ve belirli entegrasyon kısıtlamaları da dahil olmak üzere her veri türüyle ilgili teknik ayrıntılar verilmektedir.

Toplam Kalori

Toplam Kalori, bazal metabolizma ve aktif enerji dahil olmak üzere bir kullanıcının harcadığı tüm enerjiyi kilokalori (kcal) cinsinden ölçerek izleyen salt okunur bir türetilmiş veri türüdür. Değer, aktif enerji harcaması ve kullanıcının bazal metabolizma hızından hesaplanır.

Not: total-calories veri türüyle ilgili sorgular, bir zaman aralığı filtresi (ör. total_calories.interval.start_time veya total_calories.interval.civil_start_time) içermelidir. Bu sorgular için maksimum aralık 14 gündür.

Sorgu örneği

total-calories veri türünü sorgulamak için list uç noktasına aralık filtresiyle bir istek gönderin:

İstek

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

Harcanan aktif enerji

Harcanan aktif enerji, kullanıcının aktivite dönemlerinde harcadığı enerjiyi (bazal enerji harcaması hariç) temsil eder ve kilokalori (kcal) cinsinden ölçülür.

REST gösterimi örneği

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

Harcanan Bazal Enerji

Bazal enerji yakımı, kullanıcının dinlenme metabolizması nedeniyle belirli zaman aralıklarında yakılan kalorileri temsil eder ve kilokalori (kcal) cinsinden ölçülür.

Not: Toplama ve günlük toplama işlemleri bu veri türü için kullanılamaz. Günlük bazal enerji değerlerini elde etmek için Bazal Metabolizma Hızı veri türünü kullanın.

Bazal Metabolizma Hızı

Bazal metabolizma hızı, vücudun normal ve dinlenme durumunda harcadığı enerjiyi günlük kilokalori (kcal/day) cinsinden ölçer. Bu hız, zaman içinde fiziksel güncellemelerle (ör. ağırlık) değiştiği için API, BMR'yi hız örneklerinin zaman serisi olarak kaydeder.

Geliştiriciler, basal-metabolic-rate örneğindeki rateKcalPerDay alanını, yakılan bazal enerjinin günlük toplamının günlük karşılığı olarak değerlendirebilir.

REST gösterimi örneği

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

Yönergeler

Kalori ve enerji metriklerini uygulamanıza entegre ederken aşağıdaki yönergeleri kullanın:

• Günlük genel bakış: Günlük toplam kalori harcamasını göstermek için total-calories veri türünün günlük toplamını isteyin.
• Yalnızca aktivite harcaması: Belirli bir antrenman sırasında veya gün boyunca yakılan kalorileri dinlenme metabolizma hızı hariç olacak şekilde izlemek için active-energy-burned sorgusunu kullanın.
• Bazal metrikler: Dinlenme metabolizma hızını veya bazal metabolizma trendlerini izlemek için basal-metabolic-rate değerleri için sorgu gönderin. BMR örneklerini, kullanıcının dinlenme sırasındaki enerji tüketimi için günlük referans değer olarak kabul edin.