ประเภทข้อมูล Google Health API

ตารางต่อไปนี้มีรายการประเภทข้อมูลทั้งหมด โดยมีหลายคอลัมน์ ที่จะช่วยให้คุณเข้าใจการแสดงข้อมูลแต่ละประเภทใน Google Health API รวมถึงขอบเขตที่ข้อมูลแต่ละประเภทพร้อมใช้งาน

สำคัญ: รูปแบบ ของตัวระบุประเภทข้อมูลจะแตกต่างกันเมื่อประเภทข้อมูลมีมากกว่า 1 คำ ในปลายทาง ชื่อประเภทข้อมูลต้องอยู่ในรูปแบบ Kebab Case เช่น body-fat อย่างไรก็ตาม ในพารามิเตอร์ตัวกรอง ชื่อประเภทข้อมูลต้องอยู่ในรูปแบบ Snake Case เช่น body_fat.

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

ประเภทข้อมูล   dataType พารามิเตอร์   filter	ประเภท ระเบียน	การดำเนินการ ที่ใช้ได้	ขอบเขต	การสนับสนุน เว็บฮุค	การ รองรับค่าศูนย์ที่แท้จริง
แคลอรี่ที่เผาผลาญขณะทำกิจกรรม   active-energy-burned   active_energy_burned	ช่วงเวลา	list, reconcile, rollup, dailyRollup	activity_and_fitness
นาทีที่มีการใช้งาน   active-minutes   active_minutes	ช่วงเวลา	list, reconcile, rollup, dailyRollup	activity_and_fitness
นาทีในโซนแอ็กทีฟ   active-zone-minutes   active_zone_minutes	ช่วงเวลา	list, reconcile, rollup, dailyRollup	activity_and_fitness
ระดับกิจกรรม   activity-level   activity_level	ช่วงเวลา	รายการ, ปรับยอด	activity_and_fitness
ระดับความสูง   altitude   altitude	ช่วงเวลา	list, reconcile, rollup, dailyRollup	activity_and_fitness
น้ำตาลกลูโคสในเลือด   blood-glucose   blood_glucose	ตัวอย่าง	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
ไขมันในร่างกาย   body-fat   body_fat	ตัวอย่าง	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements
แคลอรี่ในโซนอัตราการเต้นของหัวใจ   calories-in-heart-rate-zone   calories_in_heart_rate_zone	ช่วงเวลา	rollup, dailyRollup	activity_and_fitness
อุณหภูมิแกนกลางของร่างกาย   core-body-temperature   core_body_temperature	ตัวอย่าง	list, get, reconcile, rollup, dailyRollup	health_metrics_and_measurements
ความผันแปรของอัตราการเต้นของหัวใจรายวัน   daily-heart-rate-variability   daily_heart_rate_variability	รายวัน	รายการ, ปรับยอด	health_metrics_and_measurements
โซนอัตราการเต้นของหัวใจรายวัน   daily-heart-rate-zones   daily_heart_rate_zones	รายวัน	รายการ, ปรับยอด	health_metrics_and_measurements
ค่าความอิ่มตัวของออกซิเจนในเลือดรายวัน   daily-oxygen-saturation   daily_oxygen_saturation	รายวัน	รายการ, ปรับยอด	health_metrics_and_measurements
อัตราการหายใจรายวัน   daily-respiratory-rate   daily_respiratory_rate	รายวัน	รายการ, ปรับยอด	health_metrics_and_measurements
อัตราการเต้นของหัวใจขณะพักประจำวัน   daily-resting-heart-rate   daily_resting_heart_rate	รายวัน	รายการ, ปรับยอด	health_metrics_and_measurements
การหาค่าอุณหภูมิขณะนอนหลับในแต่ละวัน   daily-sleep-temperature-derivations   daily_sleep_temperature_derivations	รายวัน	รายการ, ปรับยอด	health_metrics_and_measurements
VO2 Max รายวัน   daily-vo2-max   daily_vo2_max	รายวัน	รายการ, ปรับยอด	activity_and_fitness
ระยะทาง   distance   distance	ช่วงเวลา	list, reconcile, rollup, dailyRollup	activity_and_fitness
คลื่นไฟฟ้าหัวใจ (ECG)   electrocardiogram   electrocardiogram	เซสชัน	list	ecg
การออกกำลังกาย   exercise   exercise	เซสชัน	list, get, reconcile, create, update, batchDelete	activity_and_fitness
พื้น   floors   floors	ช่วงเวลา	reconcile, rollup, dailyRollup	activity_and_fitness
อาหาร   food   food	อาหาร	list, get	nutrition
หน่วยวัดอาหาร   food-measurement-unit   food_measurement_unit	อาหาร	list, get	nutrition
อัตราการเต้นของหัวใจ   heart-rate   heart_rate	ตัวอย่าง	list, reconcile, rollup, dailyRollup	health_metrics_and_measurements
ความผันแปรของอัตราการเต้นของหัวใจ   heart-rate-variability   heart_rate_variability	ตัวอย่าง	รายการ, ปรับยอด	health_metrics_and_measurements
ส่วนสูง   height   height	ตัวอย่าง	list, get, reconcile, create, update, batchDelete	health_metrics_and_measurements
บันทึกการดื่มน้ำ   hydration-log   hydration_log	เซสชัน	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	nutrition
การแจ้งเตือนเมื่อจังหวะการเต้นของหัวใจผิดปกติ   irregular-rhythm-notification   irregular_rhythm_notification	เซสชัน	list	irn
บันทึกโภชนาการ   nutrition-log   nutrition_log	ตัวอย่าง	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	nutrition
ความอิ่มตัวของออกซิเจน   oxygen-saturation   oxygen_saturation	ตัวอย่าง	รายการ, ปรับยอด	health_metrics_and_measurements
สรุปการนอนหลับเกี่ยวกับอัตราการหายใจ   respiratory-rate-sleep-summary   respiratory_rate_sleep_summary	ตัวอย่าง	รายการ, ปรับยอด	health_metrics_and_measurements
วิ่ง VO2 Max   run-vo2-max   run_vo2_max	ตัวอย่าง	list, reconcile, rollup, dailyRollup	activity_and_fitness
ระยะเวลาอยู่กับที่ไม่เคลื่อนไหว   sedentary-period   sedentary_period	ช่วงเวลา	list, reconcile, rollup, dailyRollup	activity_and_fitness
การนอนหลับ   sleep   sleep	เซสชัน	list, get, reconcile, create, update, batchDelete	การนอนหลับ
ขั้นตอน   steps   steps	ช่วงเวลา	list, reconcile, rollup, dailyRollup	activity_and_fitness
ข้อมูลความยาวของสระว่ายน้ำ   swim-lengths-data   swim_lengths_data	ช่วงเวลา	list, reconcile, rollup, dailyRollup	activity_and_fitness
เวลาในโซนอัตราการเต้นของหัวใจ   time-in-heart-rate-zone   time_in_heart_rate_zone	ช่วงเวลา	list, reconcile, rollup, dailyRollup	activity_and_fitness
แคลอรี่ทั้งหมด   total-calories   total_calories	ช่วงเวลา	rollup, dailyRollup	activity_and_fitness
VO2 Max   vo2-max   vo2_max	ตัวอย่าง	รายการ, ปรับยอด	activity_and_fitness
น้ำหนัก   weight   weight	ตัวอย่าง	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements

ข้อจำกัดของคำค้นหา

เมื่อค้นหาจุดข้อมูล การสรุป หรือการสรุปรายวันจาก API โปรดคำนึงถึงข้อจำกัดต่อไปนี้

• ข้อกำหนดของตัวกรอง: ข้อมูลที่ได้บางประเภทแบบอ่านอย่างเดียว เช่น total-calories ต้องมีตัวกรองที่ระบุเวลาเริ่มต้นของช่วง (ใช้เวลาจริงหรือเวลาพลเรือน)
• ขีดจำกัดช่วงการค้นหา: ช่วงการค้นหาสูงสุดสำหรับ calories-in-heart-rate-zone, heart-rate, active-minutes และ total-calories คือ 14 วัน ช่วงการค้นหาสูงสุดสำหรับข้อมูลประเภทอื่นๆ ทั้งหมดคือ 90 วัน

ความพร้อมใช้งานของข้อมูล

การอัปเดตข้อมูลของผู้ใช้จะพร้อมใช้งานหลังจากที่ผู้ใช้ซิงค์เครื่องมือติดตามกิจกรรมหรือป้อนข้อมูลใหม่ลงในแอป Fitbit บนมือถือหรือเว็บแอปด้วยตนเองเท่านั้น อุปกรณ์ Fitbit และแอป Fitbit บนมือถือจะซิงค์โดยอัตโนมัติทุกๆ 15 นาทีเมื่อแอป Fitbit เปิดอยู่บนอุปกรณ์เคลื่อนที่และทั้ง 2 อย่างมีการเชื่อมต่อข้อมูลที่ใช้งานอยู่และอยู่ในระยะ Bluetooth หากผู้ใช้ติดตามกิจกรรมโดยใช้ MobileTrack ระบบจะซิงค์ MobileTrack ทุกชั่วโมงตราบใดที่แอปเปิดอยู่

การค้นหาข้อมูลย้อนหลัง

ข้อดีหลักอย่างหนึ่งของ Google Health API คือความสามารถในการติดตามประสิทธิภาพของผู้ใช้และตรวจสอบค่าสุขภาพที่สำคัญเป็นระยะเวลานาน คุณสามารถค้นหาข้อมูลของผู้ใช้ได้ย้อนหลังเท่าที่ระบบบันทึกไว้ โดย API จะไม่จำกัดจำนวนข้อมูลย้อนหลังที่แอปพลิเคชันของคุณใช้ได้

อย่างไรก็ตาม การค้นหาข้อมูลย้อนหลังยังคงอยู่ภายใต้ขีดจำกัดของอัตรามาตรฐาน Google Health API รองรับการค้นหาข้อมูลในช่วงวันที่เพื่อลดจำนวนการเรียก API ที่เกี่ยวข้องกับขีดจำกัดเหล่านี้ โปรดทราบการแบ่งหน้าและขอบเขตคำขอต่อไปนี้

• แต่ละปลายทางจะแสดงผลขนาดหน้าสูงสุดที่ 10,000 จุดข้อมูลต่อหน้า
• ช่วงวันที่ของคําค้นหาถูกจํากัดไว้ระหว่าง 14 ถึง 90 วันต่อคําขอ

การดึงข้อมูลทั้งชุดอาจต้องใช้คำขอแบบต่อเนื่องหลายรายการและใช้เวลาเพิ่มเติม ทั้งนี้ขึ้นอยู่กับปริมาณข้อมูลย้อนหลังที่แอปพลิเคชันของคุณต้องการ โปรดคำนึงถึงเรื่องนี้เมื่อออกแบบกระบวนการซิงโครไนซ์ข้อมูลของแอปพลิเคชัน

สิทธิ์เข้าถึงของบุคคลที่สาม

อุปกรณ์ Fitbit สื่อสารกับแอปพลิเคชันหรือบริการของบุคคลที่สามโดยตรงไม่ได้ อุปกรณ์เหล่านี้ออกแบบมาเพื่อสื่อสารและซิงค์กับแอป Fitbit บนมือถือโดยเฉพาะ

อุปกรณ์จะซิงค์ข้อมูลโดยอัตโนมัติตลอดทั้งวันเมื่อใดก็ตามที่แอป Fitbit เปิดอยู่ หรือทุกๆ 15 นาทีหากบลูทูธเปิดอยู่และแอปทำงานใน พื้นหลัง เมื่อกระบวนการซิงค์นี้เสร็จสมบูรณ์แล้ว ข้อมูลจะพร้อมใช้งานสำหรับบริการของบุคคลที่สามผ่าน Google Health API

มาตรฐานระยะทาง

ระยะทางของการออกกำลังกาย เช่น elevationGainMillimeters จะวัดเป็นมิลลิเมตรซึ่งเป็นหน่วยมาตรฐานด้วยเหตุผลต่อไปนี้

1. รักษาความแม่นยำของข้อมูล: เหตุผลที่สำคัญที่สุดในการใช้มิลลิเมตรคือเพื่อให้มั่นใจว่าเราจะไม่สูญเสียความแม่นยำในข้อมูลที่เราอ่านและให้ การใช้หน่วยที่ละเอียด เช่น มิลลิเมตร ช่วยให้เรา แสดงการวัดได้อย่างแม่นยำ
2. การกำหนดให้เป็นมาตรฐาน: มิลลิเมตรเป็นหน่วยมาตรฐานที่ออกแบบมา ในบริการของเรา ความสอดคล้องนี้ช่วยให้มั่นใจได้ว่านักพัฒนาแอปจะได้รับประสบการณ์การใช้งานที่สม่ำเสมอ เมื่อโต้ตอบกับ API ส่วนต่างๆ
3. การรองรับระบบการวัดที่หลากหลาย: การใช้หน่วยฐาน เช่น มิลลิเมตร ช่วยให้ผู้พัฒนาแปลงเป็นหน่วยอื่นๆ ที่เลือกได้โดยตรง ไม่ว่าจะเป็นระบบเมตริก อิมพิเรียล หรือระบบการวัดอื่นๆ

ความยาวของวันไม่เท่ากัน

การจัดการเวลาโดย Health API จะจัดลำดับความสำคัญของเวลาของผู้ใช้เพื่อพิจารณา ความยาวของวันที่ที่เปลี่ยนแปลงได้ซึ่งเกิดจากเวลาออมแสงหรือการเดินทาง ระบบจะจัดเก็บจุดข้อมูลทุกจุดพร้อมทั้งการประทับเวลา UTC จริงและการชดเชย UTC ที่ใช้งานอยู่ ณ เวลาที่เกิดเหตุการณ์ ซึ่งจะช่วยให้ระบบทำสิ่งต่อไปนี้ได้

• แมปเหตุการณ์กับช่วงเวลาที่แน่นอนในโลกจริง
• แก้ไขเวลาให้ตรงกับบริบทท้องถิ่นของผู้ใช้สำหรับการรวบรวม

เวลาออมแสง

เมื่อถึงช่วงเวลาออมแสง การ "ย้อนกลับ" จะส่งผลให้วันตามปฏิทินมี 25 ชั่วโมง และข้อมูลรวมของวันที่ดังกล่าวจะมีข้อมูล 25 ชั่วโมง "การเปลี่ยนเวลา ฤดูร้อน" จะส่งผลให้วันตามกฎหมายมี 23 ชั่วโมง โดยเวลาจะเปลี่ยนกลับเป็นเวลา มาตรฐาน

ท่องเที่ยว

การเดินทางข้ามเขตเวลาอาจทำให้ระยะเวลาจริงของวันหนึ่งๆ แตกต่างกันมากยิ่งขึ้น

ใช้ปลายทาง dailyRollUp เพื่อปรับความแตกต่างของเขตเวลา ระบบจะระบุแหล่งที่มาของข้อมูลโดยอัตโนมัติเป็นวันในปฏิทินที่มีการบันทึกข้อมูล ตามเวลาท้องถิ่นของผู้ใช้ ซึ่งเป็นการ "เชื่อม" วันเข้าด้วยกัน แม้ว่าจะมีการเปลี่ยนเขตเวลาก็ตาม