कैलोरी और ऊर्जा से जुड़े डेटा टाइप

Google Health API, ऐसे डेटा टाइप उपलब्ध कराता है जो किसी व्यक्ति की कैलोरी और ऊर्जा खर्च को ट्रैक करते हैं. इन टाइप से, एनर्जी बर्न के अलग-अलग पहलुओं को मेज़र किया जाता है. जैसे, कुल खर्च, ऐक्टिव बर्न, और आराम की स्थिति में मेटाबॉलिक रेट (बेसल).

इन डेटा टाइप के बीच के अंतर को समझें, ताकि यह तय किया जा सके कि आपके ऐप्लिकेशन के लिए कौनसी मेट्रिक सही हैं.

डेटा टाइप, जो इस्तेमाल किए जा सकते हैं

एपीआई, कैलोरी और ऊर्जा खर्च का हिसाब लगाने के लिए, इन डेटा टाइप का इस्तेमाल करता है:

टेबल: Google Health API के कैलोरी डेटा टाइप

डेटा टाइप   dataType   filter पैरामीटर	Record type	उपलब्ध कार्रवाइयां	दायरा	वेबबुक support	ट्रू ज़ीरो की सुविधा
खर्च की गई ऐक्टिव एनर्जी   active-energy-burned   active_energy_burned	इंटरवल	list, reconcile, rollup, dailyRollup	activity_and_fitness
आराम करते समय खर्च हुई कैलोरी का डेटा   basal-energy-burned   basal_energy_burned	इंटरवल	सूची बनाना, मेल करना	activity_and_fitness
बेसल मेटाबॉलिक रेट   basal-metabolic-rate   basal_metabolic_rate	नमूना	सूची बनाना, मेल करना	पोषण

यहां दिए गए सेक्शन में, हर डेटा टाइप के बारे में तकनीकी जानकारी दी गई है. इसमें REST के उदाहरण और इंटिग्रेशन से जुड़ी खास पाबंदियां शामिल हैं.

कुल कैलोरी

कुल कैलोरी, सिर्फ़ पढ़ने के लिए उपलब्ध डेटा टाइप है. यह किसी उपयोगकर्ता की खर्च की गई पूरी ऊर्जा को ट्रैक करता है. इसमें बेसल मेटाबॉलिज़्म और ऐक्टिव एनर्जी शामिल है. इसे किलोकैलोरी (kcal) में मापा जाता है. इस वैल्यू का हिसाब, ऐक्टिव एनर्जी खर्च और उपयोगकर्ता के बेसल मेटाबॉलिक रेट के आधार पर लगाया जाता है.

शारीरिक गतिविधि में खर्च हुई कैलोरी

शारीरिक गतिविधि में खर्च हुई कैलोरी का डेटा, उपयोगकर्ता की शारीरिक गतिविधि के दौरान खर्च हुई कैलोरी को दिखाता है. इसमें बेसल मेटाबॉलिक रेट (बीएमआर) में खर्च हुई कैलोरी शामिल नहीं होती है. इसे किलोकैलोरी (kcal) में मापा जाता है.

REST के उदाहरण के तौर पर दिखाया गया डेटा

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

आराम करते समय खर्च हुई कैलोरी

बेसल एनर्जी बर्न से पता चलता है कि आराम करते समय, उपयोगकर्ता के शरीर में होने वाली मेटाबॉलिक गतिविधियों की वजह से कितनी कैलोरी खर्च हुई. इसे किलोकैलोरी (kcal) में मापा जाता है.

ध्यान दें: इस डेटा टाइप के लिए, रोलअप और हर दिन के रोलअप ऑपरेशन उपलब्ध नहीं हैं. हर दिन की बेसल एनर्जी वैल्यू पाने के लिए, बेसल मेटाबॉलिक रेट डेटा टाइप का इस्तेमाल करें.

बेसल मेटाबॉलिक रेट

बेसल मेटाबॉलिक रेट (बीएमआर) से यह पता चलता है कि आराम करने के दौरान शरीर कितनी एनर्जी खर्च करता है. इसे हर दिन की किलो कैलोरी (kcal/day) में मापा जाता है. समय के साथ-साथ, शरीर में होने वाले बदलावों (जैसे कि वज़न) की वजह से बीएमआर में उतार-चढ़ाव होता रहता है. इसलिए, API बीएमआर को रेट सैंपल की टाइम सीरीज़ के तौर पर रिकॉर्ड करता है.

डेवलपर, rateKcalPerDay फ़ील्ड में मौजूद basal-metabolic-rate सैंपल को, बेसल एनर्जी बर्न के रोज़ाना के रोलअप के तौर पर इस्तेमाल कर सकते हैं.

REST के उदाहरण के तौर पर दिखाया गया डेटा

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

दिशा-निर्देश

अपने ऐप्लिकेशन में कैलोरी और ऊर्जा की मेट्रिक को इंटिग्रेट करते समय, इन दिशा-निर्देशों का पालन करें:

• हर दिन का खास ब्यौरा: हर दिन खर्च की गई कुल कैलोरी दिखाने के लिए, total-calories डेटा टाइप के हर दिन के रोलअप का अनुरोध करें.
• सिर्फ़ गतिविधि के दौरान खर्च की गई कैलोरी: किसी कसरत के दौरान या पूरे दिन में खर्च की गई कैलोरी को ट्रैक करने के लिए, active-energy-burned क्वेरी करें. इसमें आराम करते समय खर्च की गई कैलोरी शामिल नहीं होती.
• बेसल मेट्रिक: बेसल मेटाबॉलिक रेट या बेसल मेटाबॉलिक ट्रेंड को ट्रैक करने के लिए, बीएमआर वैल्यू के लिए basal-metabolic-rate को क्वेरी करें. बीएमआर के सैंपल को, उपयोगकर्ता की आराम के दौरान खर्च होने वाली ऊर्जा के लिए, रोज़ाना की बेसलाइन के तौर पर इस्तेमाल करें.