匯總資料類型

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

如要讀取匯總資料，請挑選資料類型、時間範圍等等 「bucket」資料分類依據您可以透過下列幾種方式將資料分門別類：

時間範圍
可按每小時或每天的值區匯總資料。例如步數或每日燃燒的卡路里。
活動類型
依活動類型將匯總資料分組。舉例來說，針對一週的睡眠資料，每種睡眠活動類型 (淺睡、熟睡和 REM 睡眠) 各有專屬的值區。
活動區隔
按活動區隔將特定時間範圍內的匯總資料分組。舉例來說，如果使用者在上午 9 點到上午 10 點之間跑步，但後來前 20 分鐘有 10 分鐘，接著走了 15 分鐘，跑 15 分鐘，則系統會將 4 個活動區隔視為 4 個活動區隔，並傳回 4 個值區。
工作階段
使用工作階段的時間範圍來匯總資料。舉例來說，假設使用者進行 2 次跑步，但記錄為 2 個工作階段 (早上和下午跑步)，您可以依工作階段將資料分組，瞭解每次跑步的平均步數或平均速度。

活動

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

活動摘要

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

REST

名稱com.google.activity.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.activity.read
欄位 (格式：units)
activity (int，列舉)
使用者進行的活動類型。如要查看活動類型清單，請按這裡。
duration (int - 毫秒)
時間範圍內所有區隔的活動總時間。
區隔數量 (int—數量)
這個資料點在時間間隔內，不同活動區隔的數量。

Android

名稱com.google.activity.summary
資料類型物件AGGREGATE_ACTIVITY_SUMMARY
欄位 (格式：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
欄位 (格式：units)
平均 (每天 float—每日大卡)
在特定時間範圍內，使用者的平均 BMR。
max (每天 float - 大卡)
使用者在特定時間範圍內的最大 BMR 數。
min (每天 float—每日大卡)
在特定時間範圍內，使用者的最低 BMR。

Android

名稱com.google.calories.bmr.summary
資料類型物件AGGREGATE_BASAL_METABOLIC_RATE_SUMMARY
欄位 (格式：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
欄位 (格式：units)
強度 (float—心率)
你在時間範圍內獲得的心肺強化分數。 包含倍數賺取的點數 ( 較不劇烈的活動)。
duration (float - 分鐘)
獲得心肺強化分數的時間，以分鐘為單位。

Android

名稱com.google.heart_minutes.summary
資料類型物件AGGREGATE_HEART_POINTS
欄位 (格式：units)
FIELD_INTENSITY (float—心率)
你在時間範圍內獲得的心肺強化分數。 包含倍數賺取的點數 ( 較不劇烈的活動)。
FIELD_DURATION (float 分鐘)
獲得心肺強化分數的時間，以分鐘為單位。

活動時間摘要

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

電源摘要

每個資料點代表使用者在特定時間範圍內的平均功率、最大功率及最低功率。

REST

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

Android

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

步數差異摘要

每個資料點代表的是特定時間範圍內的總步數。 這個資料類型及其欄位與即時資料相同 類型。

內文

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

體脂肪百分比摘要

每個資料點代表使用者的平均、最大和最低體脂肪百分比 評估趨勢

REST

名稱com.google.body.fat.percentage.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.body.read
欄位 (格式：units)
平均 (float：百分比)
在特定時間範圍內，使用者體脂肪的總體質量百分比。
max (float，百分比)
在特定時間範圍內，使用者體脂肪的總體質量百分比上限。
min (float—百分比)
在特定時間範圍內，使用者體脂肪的總體質量百分比。

Android

名稱com.google.body.fat.percentage.summary
資料類型物件AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
欄位 (格式：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
欄位 (格式：units)
average (float - bpm)
在特定時間範圍內，使用者的平均心率 (每分鐘心跳數)。
max (float - bpm)
在特定時間範圍內，使用者的最大心率 (每分鐘心跳數)。
min (float - bpm)
在特定時間範圍內，使用者每分鐘心跳的最低心率。

Android

名稱com.google.heart_rate.summary
資料類型物件AGGREGATE_HEART_RATE_SUMMARY
欄位 (格式：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
欄位 (格式：units)
average (float—公尺)
使用者在時間範圍內的平均高度 (以公尺為單位)。
max (float—公尺)
使用者在時間範圍內的最大高度 (以公尺為單位)。
min (float—公尺)
使用者在時間範圍內的最小高度 (以公尺為單位)。

Android

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

體重摘要

每個資料點代表使用者在某 時間範圍 (以公斤為單位)。

REST

名稱com.google.weight.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.body.read
欄位 (格式：units)
平均 (float 至 kg)
在特定時間範圍內，使用者的平均體重 (以公斤為單位)。
max (float 至 kg)
使用者在特定時間範圍內的最大體重 (以公斤為單位)。
min (float 至 公斤)
使用者在特定時間範圍內的最小體重 (以公斤為單位)。

Android

名稱com.google.weight.summary
資料類型物件AGGREGATE_WEIGHT_SUMMARY
欄位 (格式：units)
FIELD_AVERAGE (float 至 kg)
在特定時間範圍內，使用者的平均體重 (以公斤為單位)。
FIELD_MAX (float 至 kg)
使用者在特定時間範圍內的最大體重 (以公斤為單位)。
FIELD_MIN (float 至 kg)
使用者在特定時間範圍內的最小體重 (以公斤為單位)。

位置

使用這些資料類型讀取匯總的位置資料。

距離差異

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

位置定界框

每個資料點代表 裝置上 算出的資料點每個定界框都有四個欄位 代表邊界方塊的四個角

REST

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

Android

名稱com.google.location.bounding_box
資料類型物件AGGREGATE_LOCATION_BOUNDING_BOX
欄位 (格式：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
欄位 (格式：units)
average (float：每秒公尺數)
使用者在時間範圍內的平均速度 (以公尺/秒為單位)。
max (float—每秒公尺數)
使用者在時間範圍內的最大速度 (以公尺/秒為單位)。
min (float—每秒公尺數)
使用者在時間範圍內的最低速度 (以公尺/秒為單位)。

Android

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

營養

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

飲水情況摘要

每個資料點代表使用者在某 以公升為單位。這個資料類型及其欄位與 即時資料類型。

營養摘要

每個資料點代表了指定時間範圍內所有營養資料項目的總和。 在營養素欄位中，每個值代表了所有營養素的總和 時間範圍。

如果營養素不在任何項目中，就不會出現在匯總地圖中 如果時間範圍內的所有項目都屬於同一餐飲，則餐飲類型 也會設定

REST

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

Android

名稱com.google.nutrition.summary
資料類型物件AGGREGATE_NUTRITION_SUMMARY
欄位 (格式：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
欄位 (格式：units)
平均 (float - mmol/L)
在特定時間範圍內，使用者的平均血糖濃度或濃度。
max (float - mmol/L)
在特定時間範圍內，使用者的最大血糖水平或濃度。
min (float - mmol/L)
在特定時間範圍內，使用者的最低血糖水平或濃度。
暫時關係 (int：列舉) (選填欄位)
讀取時間與使用者退房時間。
meal type (int：列舉) (選填欄位)
系統測量讀數時，使用者會吃的料理類型。
與睡眠時間的關係 (int：列舉) (選填欄位)
測量讀數與使用者的睡眠時間。
規格來源 (int：列舉) (選填欄位)
用於測量血糖的體液類型。

Android

名稱com.google.blood_glucose.summary
資料類型物件AGGREGATE_BLOOD_GLUCOSE_SUMMARY
欄位 (格式：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
欄位 (格式：units)
平均收縮壓 (float - mmHg)
在特定時間範圍內，使用者的平均收縮血壓。
最高 Systolic (float - mmHg)
使用者在特定時間範圍內的最大收縮血壓。
min systolic (float - mmHg)
使用者在一段時間內的最低收縮血壓。
平均舒張壓 (float - mmHg)
在特定時間範圍內，使用者的平均舒張血壓。
最大舒張壓 (float — mmHg)
在特定時間範圍內，使用者的最大舒張血壓。
min 舒張壓 (float - mmHg)
在特定時間範圍內，使用者的最低舒張血壓。
body position (int—列舉) (選填欄位)
測量期間的使用者身體位置。
測量位置 (int—列舉) (選填欄位)
測量的實驗組和別的部臂。

Android

名稱com.google.blood_pressure.summary
資料類型物件AGGREGATE_BLOOD_PRESSURE_SUMMARY
欄位 (格式：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
欄位 (格式：units)
平均 (float—攝氏)
指定時間範圍內的使用者平均體溫。
max (攝氏 float - 攝氏)
一段時間內使用者的最高體溫。
min (攝氏 float – 攝氏)
指定時間範圍內的最小體溫。
測量位置 (int—列舉) (選填欄位)
測量溫度在使用者身體上的位置。

Android

名稱com.google.body.temperature.summary
資料類型物件AGGREGATE_BODY_TEMPERATURE_SUMMARY
欄位 (格式：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
欄位 (格式：units)
平均血氧濃度 (float—百分比)
使用者在一段時間內的平均氧飽和度。
最高血氧濃度 (float—百分比)
使用者在一段時間內的最大血氧濃度。
最低血氧濃度 (float—百分比)
使用者在時間範圍內的最低血氧濃度。
平均血氧濃度 (float - L/分鐘)
在特定時間範圍內，使用者的平均補充氧氣流量。
最高氧氣補充流量 (float—L/分鐘)
一段時間內使用者的最大補充氧氣流量。
最低血氧濃度 (float - L/分鐘)
一段時間內的使用者最低補充氧氣流量。
氧氣療法管理模式 (int—列舉) (選填欄位)
氧氣療法的管理方式。
如果由 Nasal Canula 管理，則可能不存在，或 1。
氧飽和度系統 (int—列舉) (選用欄位)
用於測量氧飽和度的位置。
如果測量單位為週邊裝置，可能會缺少值，或者是 1。
氧飽和度測量方法 (int—列舉) (選填欄位)
如何測量氧飽和度。
如果計算的是脈搏血氧濃度，可能就不會顯示為 1。

Android

名稱com.google.oxygen_saturation.summary
資料類型物件AGGREGATE_OXYGEN_SATURATION_SUMMARY
欄位 (格式：units)
FIELD_OXYGEN_SATURATION_AVERAGE (float—百分比)
使用者在一段時間內的平均氧飽和度。
FIELD_OXYGEN_SATURATION_MAX (float—百分比)
使用者在一段時間內的最大血氧濃度。
FIELD_OXYGEN_SATURATION_MIN (float—百分比)
使用者在時間範圍內的最低血氧濃度。
FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE_AVERAGE (float—L/分鐘)
在特定時間範圍內，使用者的平均補充氧氣流量。
FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE_MAX (float—L/分鐘)
一段時間內使用者的最大補充氧氣流量。
FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE_MIN (float—L/分鐘)
一段時間內的使用者最低補充氧氣流量。
FIELD_OXYGEN_THERAPY_ADMINISTRATION_MODE (int—列舉) (選用欄位)
氧氣療法的管理方式。
如果由 Nasal Canula 管理，則可能不存在，或 1。
FIELD_OXYGEN_SATURATION_SYSTEM (int—列舉) (選用欄位)
用於測量氧飽和度的位置。
如果測量單位為週邊裝置，可能會缺少值，或者是 1。
FIELD_OXYGEN_SATURATION_MEASUREMENT_METHOD (int—列舉) (選用欄位)
如何測量氧飽和度。
如果計算的是脈搏血氧濃度，可能就不會顯示為 1。