匯總資料類型

對於可持續記錄的資料 (在一段時間內有多個資料點)，Google Fit 平台可以匯總這些資料並傳回計算結果。可以是平均測量結果或摘要/總數。您可以讀取匯總資料來節省時間，並讓應用程式使用者輕鬆顯示實用的摘要或平均值。

如要讀取匯總資料，您必須選擇資料類型、時間範圍，以及資料做為「值區」(或分組) 依據的條件。將資料值區分類的方法有以下幾種：

時間範圍
按每小時或每天區分的值區匯總資料。例如查看每日步數或卡路里燃燒量。
活動類型
依活動類型區分的值區匯總資料。舉例來說，如果是一週的睡眠資料，每個睡眠活動類型 (淺睡、熟睡和 REM 睡眠) 都會有一個值區。
活動區隔
按活動區隔劃分一段時間內的匯總資料。舉例來說，如果使用者開始跑步 9 點到上午 10 點，但前 20 分鐘跑步，然後結束了 10 分鐘，走動 15 分鐘，然後跑步 15 分鐘，系統就會視為 4 個活動區隔並傳回 4 個值區。
議程
使用工作階段的時間範圍來匯總資料。舉例來說，如果使用者進行 2 次跑步，系統會記錄為 2 個工作階段 (上午和下午跑步)，您可以透過時段依工作階段分類，瞭解每次跑步的平均步數或平均速度。

活動

你可以使用這些資料類型讀取健康與保健資料匯總資料。

活動摘要

特定活動在一段時間內的區隔總數和區隔數。 每個資料點代表在特定時間間隔內，特定活動類型的所有活動區隔摘要。

REST

名稱com.google.activity.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.activity.read
欄位 (format—units)
activity (int—列舉)
使用者進行的活動類型。詳情請參閱活動類型清單。
duration (int—毫秒)
在指定時間範圍內，所有時段的活動總時間。
區隔數 (int—計數)
這個資料點時間間隔內的不同活動區隔數量。

Android

名稱com.google.activity.summary
資料類型物件AGGREGATE_ACTIVITY_SUMMARY
欄位 (format—units)
FIELD_ACTIVITY (int—列舉)
使用者進行的活動類型。詳情請參閱活動類型清單。
FIELD_DURATION (int—毫秒)
在指定時間範圍內，所有時段的活動總時間。
FIELD_NUM_SEGMENTS (int—計數)
這個資料點時間間隔內的不同活動區隔數量。

基礎代謝率 (BMR) 摘要

每個資料點都代表使用者在時間範圍內的平均基礎代謝率 (以公斤為單位)。如果使用者已獲得或減重，導致 BMR 改變，這個做法就很實用。

REST

名稱com.google.calories.bmr.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.activity.read
欄位 (format—units)
平均 (每天 float—大卡)
使用者在特定時間範圍內的平均 BMR。
max (每日 float—大卡)
使用者在特定時間範圍內的最高 BMR。
min (每天 float—大卡)
使用者在特定時間範圍內的最低 BMR。

Android

名稱com.google.calories.bmr.summary
資料類型物件AGGREGATE_BASAL_METABOLIC_RATE_SUMMARY
欄位 (format—units)
FIELD_AVERAGE (每日 float—大卡)
使用者在特定時間範圍內的平均 BMR。
FIELD_MAX (每天 float—大卡)
使用者在特定時間範圍內的最高 BMR。
FIELD_MIN (每天 float—大卡)
使用者在特定時間範圍內的最低 BMR。

卡路里燃燒量摘要

一段時間內的匯總或燃燒總卡路里 (以公斤為單位)。 這個資料類型及其欄位與即時資料類型相同。

心肺強化分數摘要

每個資料點都代表這段時間範圍內獲得的心肺強化分數。

REST

名稱com.google.heart_minutes.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.activity.read
欄位 (format—units)
強度 (float：心肺強化分數)
在特定時間範圍內獲得的心肺強化分數，包括倍數積分 (高強度活動可獲得的分數越多)。
duration (float—分鐘)
獲得心肺強化分數的時間 (以分鐘為單位)。

Android

名稱com.google.heart_minutes.summary
資料類型物件AGGREGATE_HEART_POINTS
欄位 (format—units)
FIELD_INTENSITY (float：心肺強化分數)
在特定時間範圍內獲得的心肺強化分數，包括倍數積分 (高強度活動可獲得的分數越多)。
FIELD_DURATION (float 分鐘)
獲得心肺強化分數的時間 (以分鐘為單位)。

活動時間摘要

時間範圍內的總活動分鐘數。這個資料類型和欄位與即時資料類型相同。

電力摘要

每個資料點都代表使用者在特定時間範圍內產生的平均、最高和最低功率 (以瓦特為單位)。

REST

名稱com.google.power.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.activity.read
欄位 (format—units)
平均 (float—W)
使用者在特定時間範圍內產生的平均功率，以瓦特為單位。
max (float—W)
使用者在特定時間範圍內產生的最高功率，以瓦特為單位。
min (float—W)
使用者在特定時間範圍內產生的最低功率，以瓦特為單位。

Android

名稱com.google.power.summary
資料類型物件AGGREGATE_POWER_SUMMARY
欄位 (format—units)
FIELD_AVERAGE (float：瓦特)
使用者在特定時間範圍內產生的平均功率，以瓦特為單位。
FIELD_MAX (float—瓦特)
使用者在特定時間範圍內產生的最高功率，以瓦特為單位。
FIELD_MIN (float—瓦特)
使用者在特定時間範圍內產生的最低功率，以瓦特為單位。

步數差異摘要

每個資料點代表一段時間內的總步數。這個資料類型及其欄位與即時資料類型相同。

內文

使用這些資料類型讀取經過匯總的身體測量資料。

體脂肪百分比摘要

每個資料點都代表使用者在一段時間內的平均、最大和最小體脂肪百分比。

REST

名稱com.google.body.fat.percentage.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.body.read
欄位 (format—units)
平均 (float—百分比)
在一段時間內，使用者體脂肪總量的平均百分比。
max (float—百分比)
使用者在一段時間內，體脂肪總量中總體脂肪的百分比。
min (float—百分比)
在一段時間內，使用者體脂肪總量的最小百分比。

Android

名稱com.google.body.fat.percentage.summary
資料類型物件AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
欄位 (format—units)
FIELD_AVERAGE (float—百分比)
在一段時間內，使用者體脂肪總量的平均百分比。
FIELD_MAX (float—百分比)
使用者在一段時間內，體脂肪總量中總體脂肪的百分比。
FIELD_MIN (float—百分比)
在一段時間內，使用者體脂肪總量的最小百分比。

心率摘要

每個資料點都代表使用者在特定時間範圍內的平均心率、最高和最低心率，以每分鐘心跳為單位。

REST

名稱com.google.heart_rate.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.body.read
欄位 (format—units)
平均 (float—bpm)
在一段時間內，使用者的平均心率 (每分鐘心跳數)。
max (float—bpm)
在一段時間內，使用者的最大心率 (以每分鐘心跳為單位)。
min (float—bpm)
在一段時間內，使用者的最低心率 (以每分鐘心跳為單位)。

Android

名稱com.google.heart_rate.summary
資料類型物件AGGREGATE_HEART_RATE_SUMMARY
欄位 (format—units)
FIELD_AVERAGE (float—bpm)
在一段時間內，使用者的平均心率 (每分鐘心跳數)。
FIELD_MAX (float—bpm)
在一段時間內，使用者的最大心率 (以每分鐘心跳為單位)。
FIELD_MIN (float—bpm)
在一段時間內，使用者的最低心率 (以每分鐘心跳為單位)。

身高摘要

每個資料點都代表使用者在一段時間內的平均、最大和最小高度 (以公尺為單位)。

REST

名稱com.google.height.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.body.read
欄位 (format—units)
平均 (float—公尺)
使用者在一段時間內的平均高度 (以公尺為單位)。
max (float—公尺)
使用者在一段時間內的最大高度 (以公尺為單位)。
min (float—公尺)
使用者在一段時間內的最小高度 (以公尺為單位)。

Android

名稱com.google.height.summary
資料類型物件AGGREGATE_HEIGHT_SUMMARY
欄位 (format—units)
FIELD_AVERAGE (float—公尺)
使用者在一段時間內的平均高度 (以公尺為單位)。
FIELD_MAX (float—公尺)
使用者在一段時間內的最大高度 (以公尺為單位)。
FIELD_MIN (float—公尺)
使用者在一段時間內的最小高度 (以公尺為單位)。

體重摘要

每個資料點都代表使用者在一段時間內的平均、最大和最小權重 (以公斤為單位)。

REST

名稱com.google.weight.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.body.read
欄位 (format—units)
平均 (float — 公斤)
使用者在一段時間內的平均體重 (以公斤為單位)。
max (float — 公斤)
使用者在一段時間內的最大體重 (以公斤為單位)。
min (float—kg)
使用者在一段時間內的最低體重 (以公斤為單位)。

Android

名稱com.google.weight.summary
資料類型物件AGGREGATE_WEIGHT_SUMMARY
欄位 (format—units)
FIELD_AVERAGE (float—公斤)
使用者在一段時間內的平均體重 (以公斤為單位)。
FIELD_MAX (float - 公斤)
使用者在一段時間內的最大體重 (以公斤為單位)。
FIELD_MIN (float - 公斤)
使用者在一段時間內的最低體重 (以公斤為單位)。

位置

你可以使用這些資料類型讀取匯總位置資料。

距離差異

每個資料點都代表使用者在一段時間內移動的總距離 (以公尺為單位)。這個資料類型及其欄位與即時資料類型相同。

地點定界框

每個資料點都代表在一段時間內，透過使用者位置點計算出的定界框。每個定界框都有四個欄位，分別代表定界框的四個邊角。

REST

名稱com.google.location.bounding_box
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.location.read
欄位 (format—units)
低緯度 (float—度)
定界框的最小緯度，以浮點值表示。
低經度 (float—度)
定界框的最小經度，以浮點數表示，以度為單位。
高緯度 (float — 度)
定界框的最大緯度，以浮點值表示，以度為單位。
高經度 (float—度)
定界框的最大經度，以浮點值表示，以度為單位。

Android

名稱com.google.location.bounding_box
資料類型物件AGGREGATE_LOCATION_BOUNDING_BOX
欄位 (format—units)
FIELD_LOW_LATITUDE (float—度)
定界框左下角的緯度，以浮點數表示，以度為單位。
FIELD_LOW_LONGITUDE (float—度)
定界框左下角的經度，以浮點數表示，以度為單位。
FIELD_HIGH_LATITUDE (float — 度)
邊界方塊右上角的緯度，以浮點數表示，以度為單位。
FIELD_HIGH_LONGITUDE (float — 度)
定界框右上角的經度，以浮點數表示，以度為單位。

速度摘要

每個資料點都代表使用者在一段時間內的平均移動速度、最高和最低速度 (以公尺/秒為單位)。

REST

名稱com.google.speed.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.location.read
欄位 (format—units)
平均 (float：每秒公尺數)
使用者在一段時間內的平均速度 (以公尺/秒為單位)。
max (float：每秒公尺數)
使用者在時間範圍內的最高速度 (以公尺/秒為單位)。
min (float - 每秒公尺)
使用者在一段時間內的最低速度 (以公尺/秒為單位)。

Android

名稱com.google.speed.summary
資料類型物件AGGREGATE_SPEED_SUMMARY
欄位 (format—units)
平均 (float：每秒公尺數)
使用者在一段時間內的平均速度 (以公尺/秒為單位)。
max (float：每秒公尺數)
使用者在時間範圍內的最高速度 (以公尺/秒為單位)。
min (float - 每秒公尺)
使用者在一段時間內的最低速度 (以公尺/秒為單位)。

營養

使用這些資料類型讀取匯總的營養資料。

飲水量摘要

每個資料點都代表使用者在一段時間內耗用的總水量，以公升為單位。這個資料類型及其欄位與即時資料類型相同。

營養摘要

每個資料點代表一段時間內所有營養項目的總和。在「nutrients」欄位中，每個值都代表這段時間範圍內所有項目的營養素總和。

若營養素不在任何項目中，就不會顯示在匯總對應中。如果時間範圍內的所有項目都屬於同一餐，也會設定餐飲類型。

REST

名稱com.google.nutrition.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.nutrition.read
欄位 (format—units)
餐飲類型 (int：列舉)
使用者供應的餐點 (如果在時間範圍內所有條目都屬於同一道餐點，則顯示此飲食)。
營養素 (Map<String>：卡路里/公克)
在特定時間範圍內攝取的食物總營養素。

Android

名稱com.google.nutrition.summary
資料類型物件AGGREGATE_NUTRITION_SUMMARY
欄位 (format—units)
FIELD_MEAL_TYPE (int，列舉)
使用者供應的餐點 (如果在時間範圍內所有條目都屬於同一道餐點，則顯示此飲食)。
FIELD_NUTRIENTS (Map<String>：公斤/公克/毫克)
在特定時間範圍內攝取的食物總營養素。

健康狀態

你可以使用這些資料類型讀取醫療、健康資料匯總資料。

血糖摘要

每個資料點代表時間範圍內的平均血糖濃度或最高濃度，測量單位為 mmol/L，其中 1 mmol/L 為 18 mg/dL。

如果在指定時間範圍內，每個欄位的值都相同，您就可以在傳回的資料中看到欄位值：

  • 與飲食相關的時間
  • 時間與睡眠的關係
  • 樣本來源

如果測量到的各指標值都不同，系統就會排除該欄位。

REST

名稱com.google.blood_glucose.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.blood_glucose.read
欄位 (format—units)
平均 (float—mmol/L)
使用者在一段時間內的平均血糖水準或濃度。
max (float—mmol/L)
使用者在一段時間內的最大血糖水準或濃度。
min (float—mmol/L)
使用者在一段時間內的最小血糖水準或濃度。
暫時關係 (int：列舉) (選填欄位)
比較讀書的時間與使用者入住的時間。
飲食類型 (int：列舉) (選填欄位)
使用者在閱讀讀物時吃了什麼類型的餐點。
與睡眠間的關係 (int：列舉) (選填欄位)
比較讀數與使用者入睡的時間。
specimen source (int：列舉) (選填欄位)
用於測量血糖的體液類型。

Android

名稱com.google.blood_glucose.summary
資料類型物件AGGREGATE_BLOOD_GLUCOSE_SUMMARY
欄位 (format—units)
FIELD_AVERAGE (float—mmol/L)
使用者在一段時間內的平均血糖水準或濃度。
FIELD_MAX (float—mmol/L)
使用者在一段時間內的最大血糖水準或濃度。
FIELD_MIN (float—mmol/L)
使用者在一段時間內的最小血糖水準或濃度。
FIELD_TEMPORAL_RELATION_TO_MEAL (int，列舉) (選填欄位)
比較讀書的時間與使用者入住的時間。
FIELD_MEAL_TYPE (int：列舉) (選填欄位)
使用者在閱讀讀物時吃了什麼類型的餐點。
FIELD_TEMPORAL_RELATION_TO_SLEEP (int，列舉) (選填欄位)
比較讀數與使用者入睡的時間。
FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE (int—列舉) (選填欄位)
用於測量血糖的體液類型。

血壓摘要

每個資料點代表時間範圍內的平均血壓、最小和最大血壓，測量單位為 mmHg。

如果在指定時間範圍內，每個欄位的值都相同，您就可以在傳回的資料中看到欄位值：

  • 身體位置
  • 評估地點

如果測量到的各指標值都不同，系統就會排除該欄位。

REST

名稱com.google.blood_pressure.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.blood_pressure.read
欄位 (format—units)
平均收縮壓 (float—mmHg)
使用者在一段時間內的平均收縮血壓。
最大收縮壓 (float—mmHg)
使用者在特定時間範圍內的收縮血壓上限。
min 收縮壓 (float—mmHg)
使用者在一段時間內的最低收縮血壓。
平均舒張壓 (float—mmHg)
使用者在一段時間內的平均舒張血壓。
最大舒張壓 (float—mmHg)
使用者在一段時間內的舒張血壓上限。
分鐘舒張壓 (float—mmHg)
使用者在指定期間內的舒壓最低血壓。
body 位置 (int：列舉) (選填欄位)
測量結果的使用者身體位置。
測量位置 (int：列舉) (選填欄位)
測量的組別和組成部分。

Android

名稱com.google.blood_pressure.summary
資料類型物件AGGREGATE_BLOOD_PRESSURE_SUMMARY
欄位 (format—units)
FIELD_BLOOD_PRESSURE_SYSTOLIC_AVERAGE (float—mmHg)
使用者在一段時間內的平均收縮血壓。
FIELD_BLOOD_PRESSURE_SYSTOLIC_MAX (float—mmHg)
使用者在特定時間範圍內的收縮血壓上限。
FIELD_BLOOD_PRESSURE_SYSTOLIC_MIN (float—mmHg)
使用者在一段時間內的最低收縮血壓。
FIELD_BLOOD_PRESSURE_DIASTOLIC_AVERAGE (float—mmHg)
使用者在一段時間內的平均舒張血壓。
FIELD_BLOOD_PRESSURE_DIASTOLIC_MAX (float—mmHg)
使用者在一段時間內的舒張血壓上限。
FIELD_BLOOD_PRESSURE_DIASTOLIC_MIN (float—mmHg)
使用者在指定期間內的舒壓最低血壓。
FIELD_BODY_POSITION (int：列舉) (選填欄位)
測量結果的使用者身體位置。
FIELD_BLOOD_PRESSURE_MEASUREMENT_LOCATION (int：列舉) (選填欄位)
測量的組別和組成部分。

體溫摘要

每個資料點都代表使用者在一段時間內的平均、最低和最高體溫。

如果時間間隔內所有資料點的測量位置都相同，位置也會包含測量結果在主體上的位置。

REST

名稱com.google.body.temperature.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.body_temperature.read
欄位 (format—units)
平均 (float—攝氏)
在一段時間內的平均體溫。
max (float—攝氏)
使用者在特定時間範圍內的最高體溫。
min (float—攝氏)
使用者在特定時間範圍內的最低體溫。
測量位置 (int：列舉) (選填欄位)
測量溫度的使用者身體哪個位置。

Android

名稱com.google.body.temperature.summary
資料類型物件AGGREGATE_BODY_TEMPERATURE_SUMMARY
欄位 (format—units)
FIELD_AVERAGE (float—攝氏)
在一段時間內的平均體溫。
FIELD_MAX (float—攝氏)
使用者在特定時間範圍內的最高體溫。
FIELD_MIN (float—攝氏)
使用者在特定時間範圍內的最低體溫。
FIELD_BODY_TEMPERATURE_MEASUREMENT_LOCATION (int：列舉) (選填欄位)
測量溫度的使用者身體哪個位置。

血氧濃度摘要

每個資料點都代表一段時間內使用者的平均、最小和最大血氧飽和度和補充氧流量。

如果在指定時間範圍內，每個欄位的值都相同，您就可以在傳回的資料中看到欄位值：

  • 氧療法管理模式
  • 氧飽和度系統
  • 氧飽和度測量方法

如果測量到的各指標值都不同，系統就會排除該欄位。

REST

名稱com.google.oxygen_saturation.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.oxygen_saturation.read
欄位 (format—units)
平均氧飽和度 (float：百分比)
使用者在一段時間內的平均血氧飽和度。
最高氧飽和度 (float：百分比)
使用者在一段時間內的最大氧氣飽和度。
最低血氧濃度 (float：百分比)
使用者在特定時間範圍內的最低血氧濃度。
平均氧氣補充流量 (float - L/分鐘)
使用者在一段時間內的平均氧氣流動率。
最大氧氣補充流量 (float - L/分鐘)
使用者在特定時間範圍內的最大補充氧氣流量。
最小補充氧氣流動率 (float - L/分鐘)
使用者在特定時間範圍內的最低補充氧氣流量速率。
oxygen 療法管理模式 (int：列舉) (選填欄位)
氧氣療法的管理方式。
可能為沒人或 1，如果是由鼻腔控制系統所管理。
oxygen saturation system (int - 列舉) (選填欄位)
血氧濃度測量的位置。
如果以周邊毛細血管測量，則可省略或 1。
氧飽和度測量方法 (int：列舉) (選填欄位)
如何測量氧飽和度。
可為缺少或由脈搏血氧測量測出的 1。

Android

名稱com.google.oxygen_saturation.summary
資料類型物件AGGREGATE_OXYGEN_SATURATION_SUMMARY
欄位 (format—units)
FIELD_OXYGEN_SATURATION_AVERAGE (float—百分比)
使用者在一段時間內的平均血氧飽和度。
FIELD_OXYGEN_SATURATION_MAX (float—百分比)
使用者在一段時間內的最大氧氣飽和度。
FIELD_OXYGEN_SATURATION_MIN (float—百分比)
使用者在特定時間範圍內的最低血氧濃度。
FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE_AVERAGE (float—L/min)
使用者在一段時間內的平均氧氣流動率。
FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE_MAX (float—L/min)
使用者在特定時間範圍內的最大補充氧氣流量。
FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE_MIN (float—L/min)
使用者在特定時間範圍內的最低補充氧氣流量速率。
FIELD_OXYGEN_THERAPY_ADMINISTRATION_MODE (int—列舉) (選填欄位)
氧氣療法的管理方式。
可能為沒人或 1，如果是由鼻腔控制系統所管理。
FIELD_OXYGEN_SATURATION_SYSTEM (int：列舉) (選填欄位)
血氧濃度測量的位置。
如果以周邊毛細血管測量，則可省略或 1。
FIELD_OXYGEN_SATURATION_MEASUREMENT_METHOD (int—列舉) (選填欄位)
如何測量氧飽和度。
可為缺少或由脈搏血氧測量測出的 1。