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

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

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

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

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

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

Data type   dataType   filter parameter	Record type	Available operations	Scope	Webhook support	True zeros support
Steps   steps   steps	Interval	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

ส่วนต่อไปนี้จะให้รายละเอียดทางเทคนิคสำหรับประเภทข้อมูล steps ซึ่งรวมถึงตัวอย่างการแสดง REST และหลักเกณฑ์การผสานรวม

ขอบเขตที่จำเป็น

หากต้องการเข้าถึงประเภทข้อมูลนี้ แอปของคุณต้องขอขอบเขต OAuth ต่อไปนี้

• อ่าน: https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly
• เขียน: https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly

หลักเกณฑ์

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

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

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

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

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

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

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

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

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

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

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

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

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