API Google Fit, bao gồm cả API Google Fit REST, sẽ ngừng hoạt động sau ngày 30 tháng 6 năm 2025. Kể từ ngày 1 tháng 5 năm 2024, nhà phát triển không thể đăng ký sử dụng các API này.
Đối với dữ liệu có thể được ghi lại liên tục (với nhiều điểm dữ liệu trong một khoảng thời gian), nền tảng Google Fit có thể tổng hợp dữ liệu này và trả về kết quả đã tính toán. Đây có thể là số liệu đo lường trung bình hoặc số liệu tóm tắt/tổng số. Bạn
có thể tiết kiệm thời gian cho các tính toán này và cho người dùng ứng dụng của bạn thấy các bản tóm tắt hoặc
trung bình hữu ích một cách dễ dàng bằng cách đọc dữ liệu tổng hợp.
Để đọc dữ liệu tổng hợp, bạn cần chọn loại dữ liệu, khoảng thời gian và nội dung để "nhóm" (hoặc nhóm) dữ liệu theo. Bạn có thể phân nhóm dữ liệu theo một vài cách:
Khoảng thời gian
Nhóm dữ liệu tổng hợp theo giờ hoặc theo ngày. Ví dụ: xem số bước hoặc lượng calo đã đốt cháy mỗi ngày.
Loại hoạt động
Nhóm dữ liệu tổng hợp theo loại hoạt động. Ví dụ: Đối với dữ liệu giấc ngủ trong một tuần, chúng tôi sẽ có một nhóm cho từng loại hoạt động giấc ngủ (sáng, sâu và ngủ mắt chuyển động nhanh).
Phân đoạn hoạt động
Nhóm dữ liệu tổng hợp theo phân khúc hoạt động trong một khoảng thời gian. Ví dụ: nếu người dùng đã chạy trong khoảng thời gian từ 9 giờ sáng đến 10 giờ sáng nhưng đã chạy trong 20 phút đầu tiên, ngồi xuống trong 10 phút, đi bộ trong 15 phút và chạy trong 15 phút, thì đây được coi là 4 giai đoạn hoạt động và sẽ trả về 4 xô nước.
Phiên hoạt động
Sử dụng giới hạn thời gian của phiên để tổng hợp dữ liệu. Ví dụ: nếu người dùng đã chạy 2 lần chạy được ghi lại là 2 phiên (một lần chạy buổi sáng và một lần chạy vào buổi chiều), thì bạn có thể phân nhóm theo phiên để tìm hiểu các bước hoặc tốc độ trung bình của mỗi lần chạy.
Hoạt động
Sử dụng các loại dữ liệu này để đọc dữ liệu tổng hợp về sức khoẻ thể chất và tinh thần.
Tóm tắt hoạt động
Tổng thời gian và số lượng phân đoạn cho một hoạt động cụ thể trong một khoảng thời gian.
Mỗi điểm dữ liệu biểu thị một bản tóm tắt của tất cả các phân đoạn hoạt động cho một loại hoạt động cụ thể trong một khoảng thời gian.
Tổng thời gian dành cho một hoạt động trên tất cả các phân đoạn trong phạm vi thời gian đó.
FIELD_NUM_SEGMENTS (int—số lượng)
Số lượng phân đoạn hoạt động riêng biệt trong khoảng thời gian của điểm dữ liệu này.
Tóm tắt tỷ lệ trao đổi chất cơ bản (BMR)
Mỗi điểm dữ liệu biểu thị tốc độ trao đổi chất cơ bản trung bình, tối đa và tối thiểu của người dùng trong một khoảng thời gian, tính bằng kilo calo mỗi ngày. Điều này rất hữu ích nếu người dùng tăng hoặc giảm cân và do đó BMR của họ đã thay đổi.
BMR trung bình của người dùng trong một khoảng thời gian.
tối đa (float—kcal mỗi ngày)
BMR tối đa của người dùng trong một khoảng thời gian.
phút (float—kcal mỗi ngày)
BMR tối thiểu của người dùng trong một khoảng thời gian.
Android
Tên
com.google.calories.bmr.summary
Đối tượng loại dữ liệu
AGGREGATE_BASAL_METABOLIC_RATE_SUMMARY
Trường (định dạng – đơn vị)
FIELD_AVERAGE (float—kcal mỗi ngày)
BMR trung bình của người dùng trong một khoảng thời gian.
FIELD_MAX (float—kcal mỗi ngày)
BMR tối đa của người dùng trong một khoảng thời gian.
FIELD_MIN (float—kcal mỗi ngày)
BMR tối thiểu của người dùng trong một khoảng thời gian.
Thông tin tóm tắt về lượng calo đã đốt cháy
Lượng calo tổng hợp hoặc tổng lượng calo đã đốt cháy, tính bằng kilo calo, trong một khoảng thời gian.
Loại dữ liệu này và các trường của nó giống như loại dữ liệu tức thì.
Tóm tắt về Điểm nhịp tim
Mỗi điểm dữ liệu biểu thị số điểm nhịp tim đạt được trong một khoảng thời gian.
Công suất trung bình của người dùng được tạo ra trong khoảng thời gian này, tính bằng watt.
tối đa (float—watt)
Công suất tối đa mà người dùng tạo ra trong khoảng thời gian này, tính bằng watt.
tối thiểu (float—watt)
Công suất tối thiểu mà người dùng tạo ra trong khoảng thời gian này, tính bằng watt.
Android
Tên
com.google.power.summary
Đối tượng loại dữ liệu
AGGREGATE_POWER_SUMMARY
Trường (định dạng – đơn vị)
FIELD_AVERAGE (float—watt)
Công suất trung bình của người dùng được tạo ra trong khoảng thời gian này, tính bằng watt.
FIELD_MAX (float—watt)
Công suất tối đa mà người dùng tạo ra trong khoảng thời gian này, tính bằng watt.
FIELD_MIN (float—watt)
Công suất tối thiểu mà người dùng tạo ra trong khoảng thời gian này, tính bằng watt.
Tóm tắt delta số bước
Mỗi điểm dữ liệu biểu thị tổng số bước trong một khoảng thời gian.
Loại dữ liệu này và các trường của nó giống như loại dữ liệu tức thì.
Nội dung
Sử dụng các loại dữ liệu này để đọc dữ liệu tổng hợp về số đo cơ thể.
Tóm tắt tỷ lệ phần trăm mỡ trong cơ thể
Mỗi điểm dữ liệu biểu thị tỷ lệ phần trăm mỡ trong cơ thể trung bình, tối đa và tối thiểu của người dùng trong một khoảng thời gian.
Kiến trúc chuyển trạng thái đại diện (REST)
Tên
com.google.body.fat.percentage.summary
Phạm vi quyền của OAuth
https://www.googleapis.com/auth/fitness.body.read
Trường (định dạng – đơn vị)
trung bình (float – phần trăm)
Phần trăm trung bình của tổng trọng lượng cơ thể là chất béo trong cơ thể của người dùng trong một khoảng thời gian.
max (float — phần trăm)
Tỷ lệ phần trăm tối đa của tổng trọng lượng cơ thể là chất béo trong cơ thể của người dùng trong một khoảng thời gian.
tối thiểu (float—phần trăm)
Tỷ lệ phần trăm tối thiểu trên tổng trọng lượng cơ thể là chất béo trong cơ thể của người dùng trong một khoảng thời gian.
Android
Tên
com.google.body.fat.percentage.summary
Đối tượng loại dữ liệu
AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
Trường (định dạng – đơn vị)
FIELD_AVERAGE (float—phần trăm)
Phần trăm trung bình của tổng trọng lượng cơ thể là chất béo trong cơ thể của người dùng trong một khoảng thời gian.
FIELD_MAX (float — phần trăm)
Tỷ lệ phần trăm tối đa của tổng trọng lượng cơ thể là chất béo trong cơ thể của người dùng trong một khoảng thời gian.
FIELD_MIN (float — phần trăm)
Tỷ lệ phần trăm tối thiểu trên tổng trọng lượng cơ thể là chất béo trong cơ thể của người dùng trong một khoảng thời gian.
Tóm tắt về nhịp tim
Mỗi điểm dữ liệu biểu thị nhịp tim trung bình, tối đa và tối thiểu của người dùng trong một khoảng thời gian, tính bằng nhịp/phút.
Kiến trúc chuyển trạng thái đại diện (REST)
Tên
com.google.heart_rate.summary
Phạm vi quyền của OAuth
https://www.googleapis.com/auth/fitness.body.read
Trường (định dạng – đơn vị)
trung bình (float – nhịp/phút)
Nhịp tim trung bình của người dùng tính bằng nhịp/phút trong một khoảng thời gian.
tối đa (float — nhịp/phút)
Nhịp tim tối đa của người dùng tính bằng nhịp/phút trong một khoảng thời gian.
phút (float—bpm)
Nhịp tim tối thiểu của người dùng tính bằng nhịp/phút trong một khoảng thời gian.
Android
Tên
com.google.heart_rate.summary
Đối tượng loại dữ liệu
AGGREGATE_HEART_RATE_SUMMARY
Trường (định dạng – đơn vị)
FIELD_AVERAGE (float—nhịp/phút)
Nhịp tim trung bình của người dùng tính bằng nhịp/phút trong một khoảng thời gian.
FIELD_MAX (float—bpm)
Nhịp tim tối đa của người dùng tính bằng nhịp/phút trong một khoảng thời gian.
FIELD_MIN (float—bpm)
Nhịp tim tối thiểu của người dùng tính bằng nhịp/phút trong một khoảng thời gian.
Tóm tắt chiều cao
Mỗi điểm dữ liệu biểu thị chiều cao trung bình, tối đa và tối thiểu của người dùng trong một khoảng thời gian, tính bằng mét.
Kiến trúc chuyển trạng thái đại diện (REST)
Tên
com.google.height.summary
Phạm vi quyền của OAuth
https://www.googleapis.com/auth/fitness.body.read
Trường (định dạng – đơn vị)
trung bình (float—mét)
Chiều cao trung bình của người dùng trong một khoảng thời gian, tính bằng mét.
tối đa (float—mét)
Chiều cao tối đa của người dùng trong một khoảng thời gian, tính bằng mét.
phút (float—mét)
Chiều cao tối thiểu của người dùng trong một khoảng thời gian, tính bằng mét.
Android
Tên
com.google.height.summary
Đối tượng loại dữ liệu
AGGREGATE_HEIGHT_SUMMARY
Trường (định dạng – đơn vị)
FIELD_AVERAGE (float—mét)
Chiều cao trung bình của người dùng trong một khoảng thời gian, tính bằng mét.
FIELD_MAX (float—mét)
Chiều cao tối đa của người dùng trong một khoảng thời gian, tính bằng mét.
FIELD_MIN (float—mét)
Chiều cao tối thiểu của người dùng trong một khoảng thời gian, tính bằng mét.
Tóm tắt về trọng lượng
Mỗi điểm dữ liệu biểu thị trọng lượng trung bình, tối đa và tối thiểu của người dùng trong một khoảng thời gian, tính bằng kilogam.
Kiến trúc chuyển trạng thái đại diện (REST)
Tên
com.google.weight.summary
Phạm vi quyền của OAuth
https://www.googleapis.com/auth/fitness.body.read
Trường (định dạng – đơn vị)
trung bình (float—kg)
Trọng lượng cơ thể trung bình của người dùng trong một khoảng thời gian, tính bằng kilogam.
tối đa (float—kg)
Trọng lượng cơ thể tối đa của người dùng trong một khoảng thời gian, tính bằng kilogam.
tối thiểu (float—kg)
Trọng lượng cơ thể tối thiểu của người dùng trong một khoảng thời gian, tính bằng kilogam.
Android
Tên
com.google.weight.summary
Đối tượng loại dữ liệu
AGGREGATE_WEIGHT_SUMMARY
Trường (định dạng – đơn vị)
FIELD_AVERAGE (float—kg)
Trọng lượng cơ thể trung bình của người dùng trong một khoảng thời gian, tính bằng kilogam.
FIELD_MAX (float—kg)
Trọng lượng cơ thể tối đa của người dùng trong một khoảng thời gian, tính bằng kilogam.
FIELD_MIN (float—kg)
Trọng lượng cơ thể tối thiểu của người dùng trong một khoảng thời gian, tính bằng kilogam.
Vị trí
Sử dụng các loại dữ liệu này để đọc dữ liệu vị trí tổng hợp.
delta khoảng cách
Mỗi điểm dữ liệu biểu thị tổng quãng đường mà người dùng đã đi trong một khoảng thời gian, tính bằng mét. Loại dữ liệu này và các trường của nó giống như đối với loại dữ liệu tức thì.
Hộp giới hạn vị trí
Mỗi điểm dữ liệu đại diện cho hộp giới hạn được tính toán dựa trên các điểm vị trí của người dùng trong một khoảng thời gian. Mỗi hộp giới hạn có 4 trường đại diện cho 4 góc của hộp giới hạn.
Tốc độ trung bình của người dùng trong một khoảng thời gian, tính bằng mét/giây.
tối đa (float—mét/giây)
Tốc độ tối đa của người dùng trong một khoảng thời gian, tính bằng mét/giây.
phút (float—mét/giây)
Tốc độ tối thiểu của người dùng trong một khoảng thời gian, tính bằng mét/giây.
Android
Tên
com.google.speed.summary
Đối tượng loại dữ liệu
AGGREGATE_SPEED_SUMMARY
Trường (định dạng – đơn vị)
trung bình (float—mét/giây)
Tốc độ trung bình của người dùng trong một khoảng thời gian, tính bằng mét/giây.
tối đa (float—mét/giây)
Tốc độ tối đa của người dùng trong một khoảng thời gian, tính bằng mét/giây.
phút (float—mét/giây)
Tốc độ tối thiểu của người dùng trong một khoảng thời gian, tính bằng mét/giây.
Dinh dưỡng
Sử dụng các loại dữ liệu này để đọc dữ liệu tổng hợp về dinh dưỡng.
Tóm tắt về lượng nước uống
Mỗi điểm dữ liệu biểu thị tổng lượng nước mà người dùng tiêu thụ trong một khoảng thời gian, tính bằng lít. Loại dữ liệu này và các trường của nó giống như đối với loại dữ liệu tức thì.
Tóm tắt thông tin dinh dưỡng
Mỗi điểm dữ liệu thể hiện tổng của tất cả các mục dinh dưỡng trong một khoảng thời gian.
Trong trường chất dinh dưỡng, mỗi giá trị đại diện cho tổng chất dinh dưỡng trên tất cả các mục nhập trong khoảng thời gian.
Nếu không có giá trị dinh dưỡng trong bất kỳ mục nào thì chất dinh dưỡng đó cũng sẽ không có trong bản đồ tổng hợp. Nếu tất cả các mục trong khoảng thời gian này đều dành cho cùng một bữa ăn, thì loại bữa ăn cũng sẽ được đặt.
Tổng chất dinh dưỡng trong thực phẩm ăn trong một khoảng thời gian.
Giá trị được chấp nhận
"key": "calories" // Calories in kcal
"key": "fat.total" // Total fat in grams
"key": "fat.saturated" // Saturated fat in grams
"key": "fat.unsaturated" // Unsaturated fat in grams
"key": "fat.polyunsaturated" // Polyunsaturated fat in grams
"key": "fat.monounsaturated" // Monounsaturated fat in grams
"key": "fat.trans" // Trans fat in grams
"key": "cholesterol" // Cholesterol in milligrams
"key": "sodium" // Sodium in milligrams
"key": "potassium" // Potassium in milligrams
"key": "carbs.total" // Total carbohydrates in grams
"key": "dietary_fiber" // Dietary fiber in grams
"key": "sugar" // Amount of sugar in grams
"key": "protein" // Protein amount in grams
Android
Tên
com.google.nutrition.summary
Đối tượng loại dữ liệu
AGGREGATE_NUTRITION_SUMMARY
Trường (định dạng – đơn vị)
FIELD_MEAL_TYPE (int—enum)
Người dùng đã ăn loại bữa ăn nào (xuất hiện nếu tất cả các mục nhập trong khoảng thời gian đều phục vụ cùng một bữa ăn).
FIELD_NUTRIENTS (Map<String> — kilo calo/gam/miligam)
Tổng chất dinh dưỡng trong thực phẩm ăn trong một khoảng thời gian.
Giá trị được chấp nhận
NUTRIENT_CALORIES // Calories in kcal
NUTRIENT_TOTAL_FAT // Total fat in grams
NUTRIENT_SATURATED_FAT // Saturated fat in grams
NUTRIENT_UNSATURATED_FAT // Unsaturated fat in grams
NUTRIENT_POLYUNSATURATED_FAT // Polyunsaturated fat in grams
NUTRIENT_MONOUNSATURATED_FAT // Monounsaturated fat in grams
NUTRIENT_TRANS_FAT // Trans fat in grams
NUTRIENT_CHOLESTEROL // Cholesterol in milligrams
NUTRIENT_SODIUM // Sodium in milligrams
NUTRIENT_POTASSIUM // Potassium in milligrams
NUTRIENT_TOTAL_CARBS // Total carbohydrates in grams
NUTRIENT_DIETARY_FIBER // Dietary fiber in grams
NUTRIENT_SUGAR // Amount of sugar in grams
NUTRIENT_PROTEIN // Protein amount in grams
Sức khỏe
Sử dụng các loại dữ liệu này để đọc dữ liệu tổng hợp về sức khoẻ và y tế.
Tóm tắt về đường huyết
Mỗi điểm dữ liệu thể hiện mức hoặc nồng độ đường huyết trung bình, tối thiểu và tối đa trong một khoảng thời gian, được đo bằng mmol/L, trong đó 1 mmol/L là 18 mg/dL.
Nếu giá trị của mỗi trường trong số này giống nhau đối với tất cả các phép đo được thực hiện trong một phạm vi thời gian đó, thì bạn sẽ thấy giá trị của trường trong dữ liệu trả về:
mối liên hệ tạm thời với bữa ăn
mối liên hệ tạm thời với giấc ngủ
nguồn mẫu vật
Nếu các giá trị khác nhau giữa các phép đo, thì trường này sẽ bị loại trừ.
Mức đường huyết trung bình hoặc nồng độ đường huyết của người dùng trong một khoảng thời gian.
tối đa (float—mmol/L)
Mức đường huyết tối đa hoặc nồng độ đường huyết tối đa của người dùng trong một khoảng thời gian.
tối thiểu (float—mmol/L)
Mức đường huyết tối thiểu hoặc nồng độ đường huyết tối thiểu của người dùng trong một khoảng thời gian.
mối quan hệ tạm thời của bữa ăn (int – enum) (trường không bắt buộc)
Thời điểm kết quả đo được so sánh với thời điểm người dùng ăn.
Giá trị được chấp nhận
"intVal": 1 // Reading wasn't taken before or after a meal
"intVal": 2 // Reading was taken during a fasting period
"intVal": 3 // Reading was taken before a meal
"intVal": 4 // Reading was taken after a meal
mối quan hệ thời gian với giấc ngủ (int—enum) (trường không bắt buộc)
Thời điểm kết quả đo được so sánh với thời điểm người dùng ngủ.
Giá trị được chấp nhận
"intVal": 1 // User was fully awake
"intVal": 2 // Before the user fell asleep
"intVal": 3 // After the user woke up
"intVal": 4 // While the user was still sleeping
Mức đường huyết trung bình hoặc nồng độ đường huyết của người dùng trong một khoảng thời gian.
FIELD_MAX (float—mmol/L)
Mức đường huyết tối đa hoặc nồng độ đường huyết tối đa của người dùng trong một khoảng thời gian.
FIELD_MIN (float—mmol/L)
Mức đường huyết tối thiểu hoặc nồng độ đường huyết tối thiểu của người dùng trong một khoảng thời gian.
FIELD_TEMPORAL_RELATION_TO_MEAL (int—enum) (trường không bắt buộc)
Thời điểm kết quả đo được so sánh với thời điểm người dùng ăn.
Giá trị được chấp nhận
FIELD_TEMPORAL_RELATION_TO_MEAL_GENERAL // Reading wasn't taken before or after a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_FASTING // Reading was taken during a fasting period
FIELD_TEMPORAL_RELATION_TO_MEAL_BEFORE_MEAL // Reading was taken before a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_AFTER_MEAL // Reading was taken after a meal
FIELD_MEAL_TYPE (int—enum) (trường không bắt buộc)
FIELD_TEMPORAL_RELATION_TO_SLEEP (int—enum) (trường không bắt buộc)
Thời điểm kết quả đo được so sánh với thời điểm người dùng ngủ.
Giá trị được chấp nhận
TEMPORAL_RELATION_TO_SLEEP_FULLY_AWAKE // User was fully awake.
TEMPORAL_RELATION_TO_SLEEP_BEFORE_SLEEP // Before the user fell asleep.
TEMPORAL_RELATION_TO_SLEEP_ON_WAKING // After the user woke up.
TEMPORAL_RELATION_TO_SLEEP_DURING_SLEEP // While the user was still sleeping.
FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE (int—enum) (trường không bắt buộc)
Mỗi điểm dữ liệu biểu thị huyết áp trung bình, tối thiểu và tối đa trong một khoảng thời gian, được đo bằng mmHg.
Nếu giá trị của mỗi trường trong số này giống nhau đối với tất cả các phép đo được thực hiện trong một phạm vi thời gian đó, thì bạn sẽ thấy giá trị của trường trong dữ liệu trả về:
vị trí cơ thể
vị trí đo lường
Nếu các giá trị khác nhau giữa các phép đo, thì trường này sẽ bị loại trừ.
Huyết áp tâm trương trung bình của người dùng trong một khoảng thời gian.
FIELD_BLOOD_PRESSURE_DIASTOLIC_MAX (float—mmHg)
Huyết áp tâm trương tối đa của người dùng trong một khoảng thời gian.
FIELD_BLOOD_PRESSURE_DIASTOLIC_MIN (float—mmHg)
Huyết áp tâm trương tối thiểu của người dùng trong một khoảng thời gian.
FIELD_BODY_POSITION (int—enum) (trường không bắt buộc)
Vị trí cơ thể của người dùng khi đo.
Giá trị được chấp nhận
BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining
FIELD_BLOOD_PRESSURE_MEASUREMENT_LOCATION (int—enum) (trường không bắt buộc)
Nhánh và phần của nhánh được đo.
Giá trị được chấp nhận
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_WRIST // Left wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_WRIST // Right wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_UPPER_ARM // Left upper arm
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_UPPER_ARM // Right upper arm
Tóm tắt về thân nhiệt
Mỗi điểm dữ liệu biểu thị thân nhiệt trung bình, tối thiểu và tối đa của người dùng trong một khoảng thời gian.
Tệp này cũng sẽ có vị trí thực hiện phép đo trên nội dung, nếu vị trí đo lường giống nhau ở tất cả các điểm dữ liệu trong khoảng thời gian.
Mỗi điểm dữ liệu biểu thị độ bão hoà oxy trong máu trung bình, tối thiểu và tối đa cũng như tốc độ luồng oxy bổ sung của người dùng trong một khoảng thời gian.
Nếu giá trị của mỗi trường trong số này giống nhau đối với tất cả các phép đo được thực hiện trong một phạm vi thời gian đó, thì bạn sẽ thấy giá trị của trường trong dữ liệu trả về:
chế độ quản lý liệu pháp oxy
hệ thống bão hoà oxy
phương pháp đo độ bão hoà oxy
Nếu các giá trị khác nhau giữa các phép đo, thì trường này sẽ bị loại trừ.