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

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

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

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

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

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

ประเภทข้อมูล	การดำเนินการที่ใช้ได้	ขอบเขต
ก้าว dataType: steps filter parameter: steps ประเภทระเบียน: ช่วงเวลา การรองรับเว็บฮุค การรองรับค่าศูนย์จริง คำแนะนำเกี่ยวกับก้าว อุปกรณ์ที่เข้ากันได้ 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 โดยระบุระยะเวลา (เช่น 3600s สำหรับ 1 ชั่วโมง) โดยใช้พารามิเตอร์ windowSize
• ระเบียนก้าวทั้งหมด: ใช้ปลายทาง list เพื่อดึงระเบียนก้าวแบบดิบที่ละเอียดที่สุด

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

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

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

จัดการค่าศูนย์จริง

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

ซึ่งจะช่วยให้คุณแยกความแตกต่างระหว่างกรณีต่อไปนี้ได้

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

ดูรายละเอียดเพิ่มเติมได้ที่ คู่มือการแสดงข้อมูลและค่าศูนย์จริงสำหรับ