Google Health API
ปรับปรุงวิธีรายงานกิจกรรมของผู้ใช้เพื่อให้มั่นใจว่าข้อมูลมีความถูกต้องและมีการรวบรวมข้อมูลที่สอดคล้องกัน การเปิดตัว true zeros และ
on-wrist filtering ทำให้ API ช่วยให้คุณแยกความแตกต่างระหว่าง
ช่วงเวลาที่ผู้ใช้อยู่กับที่กับช่วงเวลาที่ผู้ใช้ไม่ได้สวม
อุปกรณ์ได้อย่างแม่นยำ
ศูนย์จริง
ศูนย์จริงคือจุดข้อมูลที่ชัดเจนซึ่งบ่งบอกว่าผู้ใช้สวม อุปกรณ์และติดตามอย่างต่อเนื่อง แต่ระบบบันทึกค่าเป็น 0 สำหรับเมตริกที่เฉพาะเจาะจง เช่น ผู้ใช้อาจบันทึกได้ 0 ก้าวหรือ 0 ระยะทางในช่วงเวลา 1 นาทีขณะสวมอุปกรณ์
ในอดีต ข้อมูลที่ขาดหายไปนั้นไม่ชัดเจน ซึ่งอาจหมายความว่าผู้ใช้ อยู่กับที่ไม่เคลื่อนไหวหรืออุปกรณ์ไม่ได้อยู่บนข้อมือ API จะแก้ไขปัญหานี้โดย จัดเก็บและแสดงค่า 0 อย่างชัดเจนเมื่อสวมอุปกรณ์แต่ ไม่ได้ใช้งาน ซึ่งจะช่วยให้คุณแยกความแตกต่างระหว่างช่วงเวลาที่อยู่กับที่บนข้อมือ กับข้อมูลที่ขาดหายไปได้อย่างชัดเจน
การกรองบนข้อมือ
การกรองบนข้อมือคือกระบวนการระบุว่าผู้ใช้สวมอุปกรณ์ จริงหรือไม่ ซึ่งจะช่วยให้ API กรองข้อมูลที่ไม่เกี่ยวข้องออกได้ เช่น จำนวนก้าวที่ "ไม่จริง" ซึ่งบันทึกไว้เนื่องจากการสั่นสะเทือนของยานพาหนะขณะที่อุปกรณ์อยู่ในกระเป๋า
ประเภทข้อมูลที่รองรับ
ประเภทข้อมูลต่อไปนี้รองรับพฤติกรรมเป็น 0 จริงและการกรองบนข้อมือ
- ระดับความสูง
- ระยะทาง
- ชั้น
- ขั้นตอน
- แคลอรี่ทั้งหมด
ผลกระทบต่อแอปพลิเคชัน
การใช้ค่า 0 ที่แท้จริงจะช่วยปรับปรุงความแม่นยำของการตีความช่องว่างของข้อมูล และการคำนวณเมตริก เช่น ค่าเฉลี่ยรายวัน
ลักษณะการทำงานของรายการและภาพรวม
โดยค่าเริ่มต้น Google Health API จะแสดงข้อมูลบนข้อมือเท่านั้นสำหรับประเภทข้อมูลต่อไปนี้
- การดำเนินการในรายการ: แสดงจุดข้อมูลเฉพาะช่วงเวลาที่สวมอุปกรณ์
- ช่องว่างของข้อมูล: ช่องว่างและบันทึกที่ขาดหายไปในรายการบ่งบอกว่าอุปกรณ์ ไม่ได้อยู่บนข้อมือหรือไม่ได้ซิงค์
- บันทึกที่ว่างเปล่า: ระบบจะแสดงจุดข้อมูลในช่วงที่ผู้ใช้สวม
อุปกรณ์แต่ไม่มีกิจกรรม (ค่า 0 จริง) พร้อมกับ
dataSourceปกติและข้อมูลช่วงเวลาหรือการประทับเวลา แต่จะละเว้น ฟิลด์เฉพาะเมตริก (เช่น พร็อพเพอร์ตี้count) ระบบจะตีความค่าเหล่านี้เป็นค่าศูนย์
- การดำเนินการสะสม: ค่า 0 ในการตอบกลับหมายถึงค่า 0 จริง (ผู้ใช้สวมอุปกรณ์แต่ไม่ได้เคลื่อนไหว) หากไม่ได้สวมอุปกรณ์ติดตามในช่วงเวลาที่เฉพาะเจาะจง API จะไม่แสดงข้อมูลสำหรับหน้าต่างการรวมข้อมูลนั้น
ในlistการดำเนินการ การซิงค์อุปกรณ์ที่เชื่อมต่อต่อเนื่องยังอาจทำให้เกิด
ช่วงเวลาที่ทับซ้อนกันเมื่ออัลกอริทึมในอุปกรณ์จัดกลุ่มข้อมูลการวัดระยะของเซ็นเซอร์ดิบใหม่
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการช่วงเวลาที่ทับซ้อนกันได้ที่
คู่มือการจัดการข้อมูล
การเปรียบเทียบกับ Fitbit Web API
โดยปกติแล้ว Fitbit Web API จะแสดงข้อมูล ซึ่งรวมถึงค่า 0 แม้ว่าจะไม่ได้สวม อุปกรณ์ติดตามอยู่ก็ตาม Google Health API ช่วยให้การแสดงผลการเคลื่อนไหวมีความถูกต้องแม่นยำมากขึ้น
| ฟีเจอร์ | Fitbit Web API | Google Health API |
|---|---|---|
| ความคลุมเครือของการไม่มีการใช้งาน | ข้อมูลที่ขาดหายไปอาจหมายถึงไม่มีการใช้งานหรือไม่ได้สวมใส่นาฬิกา | ค่า 0 ที่แท้จริงจะระบุอย่างชัดเจนว่าไม่มีการใช้งานขณะสวมใส่ |
| ช่องว่างของข้อมูล | ช่องว่างของข้อมูลอาจมีค่าเริ่มต้นเป็นออฟเซ็ต UTC | การจัดเก็บข้อมูลอย่างชัดเจนจะช่วยแก้ปัญหาเกี่ยวกับเขตเวลาและเวลาพลเรือน |
| การกรอง | การกรองบนข้อมือแบบจำกัด | การกรองบนข้อมืออย่างเข้มงวดช่วยให้มั่นใจได้ถึงความแม่นยำทางสรีรวิทยา |