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	beslenme

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.

Harcanan aktif enerji

Aktif yakılan enerji, kullanıcının bazal enerji harcaması hariç olmak üzere, aktivite dönemlerinde yaktığı enerjiyi 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

Harcanan bazal enerji, kullanıcının dinlenme metabolizması nedeniyle belirli zaman aralıklarında yakılan kaloriyi 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 ölçer. Bu değer, günlük kilokalori (kcal/day) cinsinden ölçülür. 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.
• Temel metrikler: Dinlenme sırasındaki metabolizma hızını veya bazal metabolizma trendlerini izlemek için basal-metabolic-rate değerleri için BMR değerlerini sorgulayın. BMR örneklerini, kullanıcının dinlenme sırasındaki enerji tüketimi için günlük bir referans değeri olarak değerlendirin.