Để đảm bảo độ chính xác của dữ liệu và các hoạt động tổng hợp nhất quán, Google Health API sẽ hiện đại hoá cách báo cáo hoạt động của người dùng. Bằng cách giới thiệu true zeros và on-wrist filtering, API này cho phép bạn phân biệt chính xác giữa các khoảng thời gian mà người dùng đứng yên so với khi họ không đeo thiết bị.
True Zeros
Giá trị 0 thực là một điểm dữ liệu rõ ràng cho biết người dùng đang đeo thiết bị và chủ động theo dõi, nhưng đã ghi nhận giá trị bằng 0 cho một chỉ số cụ thể. Ví dụ: người dùng có thể ghi lại 0 bước hoặc 0 khoảng cách trong khoảng thời gian 1 phút khi đeo thiết bị.
Trước đây, dữ liệu bị thiếu là dữ liệu không rõ ràng. Điều này có thể cho biết người dùng ít vận động hoặc thiết bị không được đeo trên cổ tay. API giải quyết vấn đề này bằng cách lưu trữ và trả về giá trị 0 một cách rõ ràng khi thiết bị được đeo nhưng không hoạt động. Điều này giúp bạn phân biệt rõ ràng giữa các khoảng thời gian thiết bị trên cổ tay ở trạng thái tĩnh và dữ liệu bị thiếu.
Lọc trên cổ tay
Lọc trên cổ tay là quy trình xác định xem người dùng có đang đeo thiết bị trên cổ tay hay không. Điều này cho phép API lọc bỏ dữ liệu không cần thiết, chẳng hạn như các bước "ảo" được ghi lại do rung động của xe trong khi thiết bị ở trong túi.
Các loại dữ liệu được hỗ trợ
Các loại dữ liệu sau đây hỗ trợ hành vi bằng 0 thực tế và tính năng lọc trên cổ tay:
- Cao độ
- Khoảng cách
- Tầng
- Các bước
- Tổng lượng calo
Ảnh hưởng đến ứng dụng của bạn
Việc triển khai giá trị 0 thực giúp cải thiện độ chính xác của việc diễn giải khoảng trống dữ liệu và tính toán chỉ số, chẳng hạn như mức trung bình hằng ngày.
Hành vi của trang thông tin và thông tin tổng quan
Theo mặc định, Google Health API chỉ trả về dữ liệu trên cổ tay cho các loại dữ liệu sau:
- Các thao tác trên danh sách: Chỉ trả về các điểm dữ liệu cho những khoảng thời gian mà thiết bị được đeo.
- Khoảng trống dữ liệu: Khoảng trống và các bản ghi bị thiếu trong danh sách cho biết thiết bị không được đeo trên cổ tay hoặc không đồng bộ hoá.
- Bản ghi trống: Các điểm dữ liệu trong thời gian người dùng đeo thiết bị nhưng không có hoạt động (giá trị bằng 0 thực sự) được trả về cùng với
dataSourcethông thường và thông tin về khoảng thời gian hoặc dấu thời gian, nhưng chúng bỏ qua trường dành riêng cho chỉ số (chẳng hạn như thuộc tínhcount). Những giá trị này phải được diễn giải là giá trị bằng 0.
- Thao tác tổng hợp: Số 0 trong phản hồi biểu thị số 0 thực (người dùng đang đeo thiết bị nhưng không di chuyển). Nếu thiết bị theo dõi không được đeo trong một khoảng thời gian cụ thể, API sẽ không trả về dữ liệu nào cho cửa sổ tổng hợp đó.
Trong các thao tác list, các hoạt động đồng bộ hoá thiết bị thông minh được kết nối liên tiếp cũng có thể tạo ra các khoảng thời gian trùng lặp khi các thuật toán trên thiết bị phân loại lại dữ liệu đo từ xa thô của cảm biến. Để biết thêm thông tin về cách xử lý các khoảng thời gian trùng lặp, hãy xem Hướng dẫn quản lý dữ liệu.
So sánh với API Fitbit Web
Fitbit Web API thường trả về dữ liệu, bao gồm cả số 0, ngay cả khi thiết bị theo dõi không được đeo. Google Health API cung cấp thông tin chính xác hơn về chuyển động.
| Tính năng | Fitbit Web API | Google Health API |
|---|---|---|
| Không rõ ràng về trạng thái không hoạt động | Việc thiếu dữ liệu có thể là do không hoạt động hoặc không đeo thiết bị. | Giá trị 0 thực sự cho biết rõ ràng tình trạng không hoạt động khi đeo. |
| Khoảng trống dữ liệu | Khoảng trống dữ liệu có thể mặc định là độ lệch UTC. | Bộ nhớ rõ ràng giải quyết các vấn đề về múi giờ và thời gian dân sự. |
| Lọc | Có giới hạn về khả năng lọc trên cổ tay. | Bộ lọc nghiêm ngặt trên cổ tay đảm bảo độ chính xác về sinh lý. |