Các kiểu dữ liệu của Google Health API

Bảng sau đây chứa danh sách đầy đủ các loại dữ liệu, với một số cột để giúp bạn hiểu rõ cách biểu thị từng loại trong Google Health API, cũng như phạm vi mà từng loại có sẵn.

Lưu ý quan trọng: Định dạng của mã nhận dạng loại dữ liệu sẽ khác khi loại dữ liệu có nhiều từ. Trong một điểm cuối, tên loại dữ liệu phải ở dạng kebab case, chẳng hạn như body-fat. Tuy nhiên, trong một tham số bộ lọc, tên kiểu dữ liệu phải ở dạng snake case, chẳng hạn như body_fat.

Bảng: Các kiểu dữ liệu của Google Health API

Loại dữ liệu   Mã nhận dạng thiết bị đầu cuối   Tham số bộ lọc	Loại bản ghi	Các thao tác có thể thực hiện	Phạm vi	Hỗ trợ webhook
Số phút hoạt động   active-minutes   active_minutes	Khoảng thời gian	reconcile, rollup, dailyRollup	activity_and_fitness
Số phút hoạt động cho vùng nhịp tim   active-zone-minutes   active_zone_minutes	Khoảng thời gian	list, reconcile, rollup, dailyRollup	activity_and_fitness
Mức độ hoạt động   activity-level   activity_level	Khoảng thời gian	liệt kê, điều chỉnh	activity_and_fitness
Độ cao   altitude   altitude	Khoảng thời gian	list, reconcile, rollup, dailyRollup	activity_and_fitness
Lượng mỡ trong cơ thể   body-fat   body_fat	Mẫu	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements
Lượng calo tiêu thụ theo vùng nhịp tim   calories-in-heart-rate-zone   calories_in_heart_rate_zone	Khoảng thời gian	rollup, dailyRollup	activity_and_fitness
Sự thay đổi tần số tim hằng ngày   daily-heart-rate-variability   daily_heart_rate_variability	Hằng ngày	liệt kê, điều chỉnh	health_metrics_and_measurements
Vùng tần số tim hằng ngày   daily-heart-rate-zones   daily_heart_rate_zones	Hằng ngày	điều chỉnh	health_metrics_and_measurements
Độ bão hoà oxy hằng ngày   daily-oxygen-saturation   daily_oxygen_saturation	Hằng ngày	liệt kê, điều chỉnh	health_metrics_and_measurements
Nhịp thở hằng ngày   daily-respiratory-rate   daily_respiratory_rate	Hằng ngày	liệt kê, điều chỉnh	health_metrics_and_measurements
Tần số tim lúc nghỉ ngơi hằng ngày   daily-resting-heart-rate   daily_resting_heart_rate	Hằng ngày	liệt kê, điều chỉnh	health_metrics_and_measurements
Dữ liệu nhiệt độ cơ thể hằng ngày khi ngủ   daily-sleep-temperature-derivations   daily_sleep_temperature_derivations	Hằng ngày	liệt kê, điều chỉnh	health_metrics_and_measurements
Lượng oxy tối đa hằng ngày   daily-vo2-max   daily_vo2_max	Hằng ngày	liệt kê, điều chỉnh	activity_and_fitness
Khoảng cách   distance   distance	Khoảng thời gian	list, reconcile, rollup, dailyRollup	activity_and_fitness
Bài tập   exercise   exercise	Phiên	list, get, reconcile, create, update, batchDelete	activity_and_fitness
Floors   floors   floors	Khoảng thời gian	reconcile, rollup, dailyRollup	activity_and_fitness
Nhịp tim   heart-rate   heart_rate	Mẫu	list, reconcile, rollup, dailyRollup	health_metrics_and_measurements
Sự thay đổi tần số tim   heart-rate-variability   heart_rate_variability	Mẫu	liệt kê, điều chỉnh	health_metrics_and_measurements
Nhật ký về lượng nước uống   hydration-log   hydration_log	Phiên	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	dinh dưỡng
Độ bão hoà oxy   oxygen-saturation   oxygen_saturation	Mẫu	liệt kê, điều chỉnh	health_metrics_and_measurements
Tóm tắt nhịp thở khi ngủ   respiratory-rate-sleep-summary   respiratory_rate_sleep_summary	Mẫu	liệt kê, điều chỉnh	health_metrics_and_measurements
Tốc độ tiêu thụ oxy tối đa khi chạy   run-vo2-max   run_vo2_max	Mẫu	list, reconcile, rollup, dailyRollup	activity_and_fitness
Giai đoạn ít vận động   sedentary-period   sedentary_period	Khoảng thời gian	list, reconcile, rollup, dailyRollup	activity_and_fitness
Ngủ   sleep   sleep	Phiên	list, get, reconcile, create, update, batchDelete	ngủ
Các bước   steps   steps	Khoảng thời gian	list, reconcile, rollup, dailyRollup	activity_and_fitness
Thời gian ở vùng tần số tim   time-in-heart-rate-zone   time_in_heart_rate_zone	Khoảng thời gian	reconcile, rollup, dailyRollup	activity_and_fitness
Tổng lượng calo   total-calories   total_calories	Khoảng thời gian	rollup, dailyRollup	activity_and_fitness
VO2 Max   vo2-max   vo2_max	Mẫu	list, reconcile	activity_and_fitness
Trọng số   weight   weight	Mẫu	list, get, reconcile, rollup, dailyRollup, create, update, batchDelete	health_metrics_and_measurements

Phạm vi cung cấp dữ liệu

Dữ liệu của người dùng chỉ được cập nhật sau khi họ đồng bộ hoá thiết bị theo dõi hoạt động hoặc nhập dữ liệu mới theo cách thủ công vào ứng dụng di động hoặc ứng dụng web Fitbit. Thiết bị Fitbit và ứng dụng di động Fitbit có thể tự động đồng bộ hoá sau mỗi 15 phút khi ứng dụng Fitbit đang mở trên thiết bị di động và hai thiết bị này có kết nối dữ liệu đang hoạt động và nằm trong phạm vi Bluetooth. Nếu người dùng đang theo dõi hoạt động bằng MobileTrack, thì MobileTrack sẽ đồng bộ hoá mỗi giờ miễn là ứng dụng đang mở.

Tiêu chuẩn về khoảng cách

Khoảng cách tập thể dục, chẳng hạn như elevationGainMillimeters, được đo bằng milimet làm đơn vị tiêu chuẩn vì những lý do sau:

1. Duy trì độ chính xác của dữ liệu: Lý do quan trọng nhất để sử dụng đơn vị milimet là để đảm bảo chúng tôi không mất đi độ chính xác nào trong dữ liệu mà chúng tôi đọc và cung cấp. Việc sử dụng một đơn vị đo lường chi tiết như milimet cho phép chúng tôi biểu thị các phép đo với độ chính xác cao.
2. Tiêu chuẩn hoá: Milimet là đơn vị tiêu chuẩn được thiết kế trên các dịch vụ của chúng tôi. Tính nhất quán này giúp đảm bảo trải nghiệm đồng nhất cho các nhà phát triển tương tác với nhiều phần của API.
3. Hỗ trợ hệ thống đo lường rộng: Việc sử dụng một đơn vị cơ bản như milimet giúp nhà phát triển dễ dàng chuyển đổi sang bất kỳ đơn vị nào khác mà họ chọn, bất kể họ đang làm việc với hệ thống đo lường bằng mét, hệ thống đo lường của Anh hoặc các hệ thống đo lường khác.