พัฒนาประสบการณ์การใช้งานขั้นตอนต่างๆ ด้วย Google Health API

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

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

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

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

ตาราง: ประเภทข้อมูลจำนวนก้าวของ Google Health API

ประเภทข้อมูล	การดำเนินการ ที่ใช้ได้	ขอบเขต
ขั้นตอน dataType: steps filter parameter: steps ประเภทระเบียน: Interval ความละเอียดของพื้นที่เก็บข้อมูล: 1 นาที การสนับสนุนเว็บฮุค การสนับสนุน True Zeros คู่มือแบบทีละขั้นตอน อุปกรณ์ที่เข้ากันได้ Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

หลักเกณฑ์

เมื่อผสานรวมการติดตามจำนวนก้าวเข้ากับแอป ให้ทำตามหลักเกณฑ์การออกแบบและการใช้งานต่อไปนี้

การคำนวณความเร็วและเพซ

Google Health API ใช้สูตรมาตรฐานในการคำนวณความเร็วและเพซ ดังนี้

• ความเร็ว = distance / time(hour)
• เพซ = time(seconds) / distance

ส่วนหัว Accept-Language ที่ระบุในคำขอจะกำหนดหน่วยของระยะทาง

ภาพรวมประจำวัน

หากต้องการรวมจำนวนก้าวรายวันอย่างถูกต้องภายใต้การเดินทาง การเปลี่ยนแปลงเขตเวลา หรือเวลาออมแสง อย่าทำการคำนวณระยะเวลาฝั่งไคลเอ็นต์ แต่ให้ค้นหาปลายทาง dailyRollUp ซึ่งจะปรับช่องว่างของข้อมูลทางกายภาพโดยอัตโนมัติโดยใช้ค่าออฟเซ็ต UTC แทน การรวมจะแสดงผล StepsRollupValue ที่มีฟิลด์ countSum ซึ่งแสดงจำนวนก้าวสะสมทั้งหมดสำหรับวันที่ขอ โปรดดูรายละเอียดที่หัวข้อรวมข้อมูลตามวันในปฏิทินในคู่มือข้อมูลรวม

การวาดอินเทอร์เฟซผู้ใช้ (การปรับยอด)

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

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

การติดตามระหว่างวันและฮิสโตแกรม

หากต้องการแสดงกิจกรรมของผู้ใช้อย่างละเอียดตลอดทั้งวัน (เช่น แผนภูมิและกราฟ) ให้ทำดังนี้

• ฮิสโตแกรมจำนวนก้าวรายชั่วโมงหรือรายนาที: ค้นหาปลายทาง rollUp โดยระบุระยะเวลา (เช่น 60s สำหรับ 1 นาที หรือ 3600s สำหรับ 1 ชั่วโมง) โดยใช้พารามิเตอร์ windowSize เนื่องจากระบบจะบันทึกข้อมูลจำนวนก้าวเป็นช่วงเวลา 1 นาที (60s) ให้ตั้งค่า windowSize เป็นอย่างน้อย 60s คำขอที่มีขนาดกรอบเวลาต่ำกว่า 1 นาที (เช่น 10s หรือ 30s) จะไม่แบ่งยอดรวมของแต่ละนาที แต่จะใส่จำนวนของทั้งนาทีลงในที่เก็บย่อยแรกที่ตรงกัน โปรดดูรายละเอียดที่หัวข้อกรอบเวลาการรวมข้อมูลและความละเอียดของพื้นที่เก็บข้อมูล
• บันทึกจำนวนก้าวทั้งหมด: ใช้ปลายทาง list เพื่อดึงข้อมูลบันทึกจำนวนก้าวแบบดิบที่ละเอียดที่สุด

ปลายทาง rollUp, dailyRollUp และ reconcile ยอมรับพารามิเตอร์ dataSourceFamily ซึ่งช่วยให้คุณกรองข้อมูลจากกลุ่มแหล่งที่มาที่เฉพาะเจาะจงได้ ดูรายละเอียดเพิ่มเติมและตัวอย่างการใช้งานได้ที่ส่วนกรองตามตระกูลแหล่งข้อมูลของคู่มือการกรองข้อมูล

การซิงค์แบบเรียลไทม์โดยใช้เว็บฮุค

สมัครรับคอลเล็กชันประเภทข้อมูล steps เพื่อรับการแจ้งเตือนแบบเรียลไทม์เมื่อมีการนำเข้าหรือซิงค์ข้อมูลจำนวนก้าวใหม่ อัปเดตแดชบอร์ดฝั่งไคลเอ็นต์แบบไดนามิกเพื่อตอบสนองต่อการแจ้งเตือนของเว็บฮุคเหล่านี้ แทนที่จะทำการโพลปลายทาง REST ดูรายละเอียดเกี่ยวกับวิธีตั้งค่าการสมัครใช้บริการได้ที่การสมัครใช้บริการ Webhook