ประเภทข้อมูลแคลอรีและพลังงาน

Google Health API มีประเภทข้อมูลที่ติดตามแคลอรี่และการใช้พลังงานของผู้ใช้ ซึ่งจะวัดการเผาผลาญพลังงานในด้านต่างๆ รวมถึงการใช้พลังงานทั้งหมด การเผาผลาญขณะทำกิจกรรม และอัตราการเผาผลาญขณะพัก (พื้นฐาน)

ทําความเข้าใจความแตกต่างระหว่างประเภทข้อมูลเหล่านี้เพื่อพิจารณาว่าเมตริกใด เหมาะกับแอปพลิเคชันของคุณ

ประเภทข้อมูลที่รองรับ

API รองรับประเภทข้อมูลต่อไปนี้สำหรับการวัดแคลอรี่และพลังงานที่ใช้ไป

ตาราง: ประเภทข้อมูลแคลอรี่ของ Google Health API

ประเภทข้อมูล   dataType พารามิเตอร์   filter	ประเภท ระเบียน	การดำเนินการ ที่ใช้ได้	ขอบเขต	การสนับสนุน เว็บฮุค	การสนับสนุน สำหรับค่าศูนย์ที่แท้จริง
แคลอรี่ที่ใช้ไป   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)

หมายเหตุ: การดำเนินการสรุปและสรุปรายวันไม่พร้อมใช้งานสำหรับประเภทข้อมูลนี้ หากต้องการรับค่าพลังงานพื้นฐานรายวัน ให้ใช้ประเภทข้อมูลอัตราการเผาผลาญพื้นฐาน

อัตราการเผาผลาญขณะพัก

อัตราการเผาผลาญขณะพัก (Basal Metabolic Rate หรือ BMR) จะวัดพลังงานที่ร่างกายใช้ในสภาวะปกติขณะพักผ่อน ซึ่งวัดเป็นกิโลแคลอรี่ต่อวัน (kcal/day) เนื่องจากอัตรานี้จะผันแปรตามการเปลี่ยนแปลงทางร่างกาย (เช่น น้ำหนัก) เมื่อเวลาผ่านไป API จึงบันทึก BMR เป็นอนุกรมเวลาของตัวอย่างอัตรา

นักพัฒนาแอปสามารถถือว่าฟิลด์ rateKcalPerDay ในbasal-metabolic-rate ตัวอย่างเป็นค่าเทียบเท่ารายวันของการสรุปรายวันของพลังงานที่ใช้ไป

ตัวอย่างการแสดง REST

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

หลักเกณฑ์

เมื่อผสานรวมเมตริกแคลอรี่และพลังงานในแอป ให้ใช้หลักเกณฑ์ต่อไปนี้

• ภาพรวมรายวัน: หากต้องการแสดงการใช้จ่ายแคลอรีรายวันโดยรวม ให้ขอ การสรุปรายวันของtotal-caloriesประเภทข้อมูล
• ค่าใช้จ่ายสำหรับกิจกรรมเท่านั้น: หากต้องการติดตามแคลอรี่ที่ใช้ไปในระหว่างการออกกำลังกายที่เฉพาะเจาะจง หรือตลอดทั้งวันโดยไม่รวมอัตราการเผาผลาญขณะพัก ให้ค้นหาactive-energy-burned
• เมตริกพื้นฐาน: หากต้องการติดตามอัตราการเผาผลาญขณะพักหรือแนวโน้มอัตราการเผาผลาญขณะพัก ให้ค้นหา basal-metabolic-rate สำหรับค่า BMR ถือว่าตัวอย่าง BMR เป็นเกณฑ์พื้นฐานรายวันสำหรับการใช้พลังงานขณะพักของผู้ใช้