API Google Health theo dõi số bước và dữ liệu hoạt động của người dùng bằng cách sử dụng loại dữ liệu steps. Số bước là một chỉ số cơ bản về hoạt động thể chất hằng ngày, giúp nhà phát triển theo dõi tiến trình tập thể dục, tính toán mức tiêu hao năng lượng và xây dựng bản tóm tắt hoạt động hằng ngày dành cho người dùng.
Tìm hiểu cách đọc và cấu trúc các chỉ số về số bước trong ứng dụng để mang lại trải nghiệm tốt nhất cho người dùng.
Các loại dữ liệu được hỗ trợ
API này hỗ trợ loại dữ liệu sau để theo dõi số bước:
| Loại dữ liệu | Các thao tác có thể thực hiện |
Phạm vi |
|---|---|---|
|
Các bước
dataType:
stepsfilter parameter: steps
Loại bản ghi: Khoảng thời gian
Giải pháp về bộ nhớ: 1 phút
Thiết bị tương thích
|
list, reconcile, rollup, dailyRollup | .activity_and_fitness.readonly.activity_and_fitness.writeonly |
Nguyên tắc
Khi tích hợp tính năng theo dõi số bước vào ứng dụng, hãy làm theo các nguyên tắc thiết kế và triển khai sau đây.
Tính toán tốc độ và nhịp độ
API Google Health sử dụng các công thức chuẩn để tính tốc độ và nhịp độ:
- Tốc độ =
distance / time(hour) - Tốc độ =
time(seconds) / distance
Tiêu đề Accept-Language được chỉ định trong yêu cầu sẽ xác định đơn vị khoảng cách.
Tổng quan hằng ngày
Để tổng hợp chính xác số bước hằng ngày khi di chuyển, thay đổi múi giờ hoặc giờ mùa hè, đừng thực hiện các phép tính thời lượng phía máy khách. Thay vào đó, hãy truy vấn điểm cuối dailyRollUp để tự động điều chỉnh khoảng trống dữ liệu thực tế bằng cách sử dụng độ lệch UTC. Bản tóm tắt trả về một StepsRollupValue chứa trường countSum, đại diện cho tổng số bước tích luỹ trong ngày được yêu cầu. Để biết thông tin chi tiết, hãy xem phần Tổng hợp theo ngày theo lịch trong hướng dẫn dữ liệu tổng hợp.
Vẽ giao diện người dùng (Điều chỉnh)
Khi tạo các thành phần giao diện người dùng để hiển thị dữ liệu về số bước, hãy sử dụng điểm cuối reconcile. Nếu nhiều nguồn dữ liệu (chẳng hạn như đồng hồ thông minh và điện thoại di động)
đã ghi lại số bước cùng một lúc, thì điểm cuối reconcile sẽ giải quyết
các xung đột và hợp nhất các luồng để trả về một luồng dữ liệu duy nhất, đã được điều chỉnh.
Để biết thông tin về cách xử lý các khoảng thời gian trùng lặp khi đồng bộ hoá thiết bị đã kết nối và khả năng thay đổi dấu thời gian, hãy xem Hướng dẫn quản lý dữ liệu.
Theo dõi và biểu đồ trong ngày
Để hiển thị hoạt động chi tiết của người dùng trong suốt cả ngày (chẳng hạn như biểu đồ và đồ thị):
- Biểu đồ bước theo giờ hoặc phút: Truy vấn điểm cuối
rollUp, chỉ định thời lượng (chẳng hạn như60scho 1 phút hoặc3600scho 1 giờ) bằng tham sốwindowSize. Vì dữ liệu về số bước được ghi lại theo khoảng thời gian 1 phút (60s), hãy đặtwindowSizethành ít nhất60s. Các yêu cầu có kích thước cửa sổ dưới một phút (chẳng hạn như10shoặc30s) không chia nhỏ tổng số phút riêng lẻ, mà đặt tổng số phút vào bộ chứa phụ phù hợp đầu tiên. Để biết thông tin chi tiết, hãy xem phần Cửa sổ tổng hợp và độ phân giải bộ nhớ. - Tất cả bản ghi số bước: Sử dụng điểm cuối
listđể tìm nạp các bản ghi số bước thô, chi tiết nhất.
Các điểm cuối rollUp, dailyRollUp và reconcile chấp nhận tham số dataSourceFamily, cho phép bạn lọc dữ liệu từ các nhóm nguồn cụ thể. Để biết thêm thông tin chi tiết và ví dụ về cách sử dụng, hãy xem phần Lọc theo nhóm nguồn dữ liệu trong hướng dẫn Lọc dữ liệu.
Đồng bộ hoá theo thời gian thực bằng webhook
Đăng ký thu thập kiểu dữ liệu steps để nhận thông báo theo thời gian thực khi dữ liệu bước mới được nhập hoặc đồng bộ hoá. Thay vì thăm dò ý kiến các điểm cuối REST, hãy cập nhật linh động trang tổng quan phía máy khách để phản hồi các thông báo webhook này. Để biết thông tin chi tiết về cách thiết lập gói thuê bao, hãy xem phần Gói thuê bao webhook.