匯總資料類型

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

如要讀取匯總資料,您需要選擇資料類型、日期範圍,以及用來「分類」(或分組) 資料的項目。你可以透過幾種方式將資料分組:

時間範圍
按小時或按天彙整資料。例如,查看每日步數或卡路里燃燒量。
活動類型
依活動類型將匯總資料分類。舉例來說,如果是一週的睡眠資料,系統會為每種睡眠活動類型 (淺睡、深睡和快速動眼睡眠) 建立一個資料桶。
活動行程
依時間範圍將活動區隔的匯總資料分組。舉例來說,假設使用者在上午 9 點到 10 點之間跑步,但只跑了前 20 分鐘,接著坐下休息 10 分鐘,然後步行 15 分鐘,最後再跑 15 分鐘,這些會視為 4 個活動區段,並傳回 4 個值區。
工作階段
使用工作階段的時間界線匯總資料。舉例來說,如果使用者進行了 2 次跑步活動,系統會記錄為 2 個工作階段 (上午和下午各一次),您可以依工作階段分組,瞭解每次跑步的平均步數或平均速度。

活動

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

活動摘要

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

REST

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

Android

名稱com.google.activity.summary
資料類型物件AGGREGATE_ACTIVITY_SUMMARY
欄位 (格式:單位)
FIELD_ACTIVITY (int—列舉)
使用者執行的活動類型。如要查看活動類型清單,請按這裡
FIELD_DURATION (int—毫秒)
在時間範圍內,所有區隔的活動總時間。
FIELD_NUM_SEGMENTS (int—count)
這個資料點時間間隔內的不重複活動區段數。

基礎代謝率 (BMR) 摘要

每個資料點代表使用者在時間範圍內的平均、最高和最低基礎代謝率 (以每日千卡為單位)。如果使用者體重增加或減少,基礎代謝率也會隨之改變,這時這項功能就派得上用場。

REST

名稱com.google.calories.bmr.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.activity.read
欄位 (格式:單位)
平均 (每天 float 大卡)
使用者在一段時間內的平均基礎代謝率。
最多 (每日 float 大卡)
使用者在一段時間範圍內的最大基礎代謝率。
分鐘 (每天 float 大卡)
使用者在一段時間內的最低基礎代謝率。

Android

名稱com.google.calories.bmr.summary
資料類型物件AGGREGATE_BASAL_METABOLIC_RATE_SUMMARY
欄位 (格式:單位)
FIELD_AVERAGE (每日 float 大卡)
使用者在一段時間內的平均基礎代謝率。
FIELD_MAX (每天 float 大卡)
使用者在一段時間範圍內的最大基礎代謝率。
FIELD_MIN (每日 float 大卡)
使用者在一段時間內的最低基礎代謝率。

卡路里燃燒量摘要

在一段時間範圍內燃燒的總卡路里燃燒量 (以大卡為單位)。這個資料類型及其欄位與即時資料類型相同。

心肺強化分數摘要

每個資料點代表在該時間範圍內獲得的心肺活力點數。

REST

名稱com.google.heart_minutes.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.activity.read
欄位 (格式:單位)
強度 (float 心肺強化分數)
這段時間範圍內獲得的心肺強化分數,包括透過加倍點數獲得的分數 (從事更劇烈的活動可獲得更多分數)。
時間長度 (float 分鐘)
獲得心肺強化分數的時間,以分鐘為單位。

Android

名稱com.google.heart_minutes.summary
資料類型物件AGGREGATE_HEART_POINTS
欄位 (格式:單位)
FIELD_INTENSITY (float - 心肺強化分數)
這段時間範圍內獲得的心肺強化分數,包括透過加倍點數獲得的分數 (從事更劇烈的活動可獲得更多分數)。
FIELD_DURATION (float 分鐘)
獲得心肺強化分數的時間,以分鐘為單位。

活動時間摘要

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

電量摘要

每個資料點代表使用者在一段時間範圍內的平均、最大和最小發電量 (以瓦特為單位)。

REST

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

Android

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

步數差異摘要

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

內文

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

體脂肪百分比摘要

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

REST

名稱com.google.body.fat.percentage.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.body.read
欄位 (格式:單位)
平均 (float%)
使用者在一段時間範圍內的平均體脂肪百分比。
max (float%)
使用者在一段時間範圍內,體脂肪占總體重的最高百分比。
min (float%)
使用者在一段時間範圍內的體脂肪占總體重的最低百分比。

Android

名稱com.google.body.fat.percentage.summary
資料類型物件AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
欄位 (格式:單位)
FIELD_AVERAGE (float—百分比)
使用者在一段時間範圍內的平均體脂肪百分比。
FIELD_MAX (float 百分比)
使用者在一段時間範圍內,體脂肪占總體重的最高百分比。
FIELD_MIN (float 百分比)
使用者在一段時間範圍內的體脂肪占總體重的最低百分比。

心率摘要

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

REST

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

Android

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

Android

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

體重摘要

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

REST

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

Android

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

位置

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

距離差異

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

位置定界框

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

REST

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

Android

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

Android

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

營養

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

飲水量摘要

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

營養摘要

每個資料點代表一段時間範圍內所有營養素記錄的總和。在營養素欄位中,每個值代表該時間範圍內所有項目的營養素總和。

如果營養素未出現在任何項目中,也不會出現在匯總地圖中。如果時間範圍內的所有記錄都是同一餐,系統也會設定餐別。

REST

名稱com.google.nutrition.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.nutrition.read
欄位 (格式:單位)
餐點類型 (int—列舉)
使用者吃的餐點類型 (如果時間範圍內的所有記錄都是同一餐,就會顯示這項資訊)。
營養素 (Map<String> - 大卡/公克)
一段時間內所吃食物的總營養素。

Android

名稱com.google.nutrition.summary
資料類型物件AGGREGATE_NUTRITION_SUMMARY
欄位 (格式:單位)
FIELD_MEAL_TYPE (int—enum)
使用者吃的餐點類型 (如果時間範圍內的所有記錄都是同一餐,就會顯示這項資訊)。
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
欄位 (格式:單位)
平均值 (float mmol/L)
使用者在一段時間範圍內的平均血糖值或濃度。
max (float—mmol/L)
使用者在一段時間範圍內的最高血糖值或濃度。
min (float—mmol/L)
使用者在一段時間內的最低血糖值或濃度。
與餐點的時間關係 (int—列舉) (選用欄位)
與使用者進食時間相比,血糖讀數的測量時間。
餐點類型 (int—列舉) (選填欄位)
使用者在讀數記錄時間前後吃的餐點類型。
與睡眠的時序關係 (int—列舉) (選填欄位)
讀數是在使用者睡眠期間的哪個時間點取得。
檢體來源 (int—列舉) (選填欄位)
用於測量血糖的體液類型。

Android

名稱com.google.blood_glucose.summary
資料類型物件AGGREGATE_BLOOD_GLUCOSE_SUMMARY
欄位 (格式:單位)
FIELD_AVERAGE (float—mmol/L)
使用者在一段時間範圍內的平均血糖值或濃度。
FIELD_MAX (float—mmol/L)
使用者在一段時間範圍內的最高血糖值或濃度。
FIELD_MIN (float—mmol/L)
使用者在一段時間內的最低血糖值或濃度。
FIELD_TEMPORAL_RELATION_TO_MEAL (int—enum) (選用欄位)
與使用者進食時間相比,血糖讀數的測量時間。
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
欄位 (格式:單位)
平均收縮壓 (float—mmHg)
使用者在一段時間內的平均收縮壓。
最高收縮壓 (float mmHg)
使用者在一段時間內的最高收縮壓。
最低收縮壓 (float—mmHg)
使用者在一段時間範圍內的最低收縮血壓。
平均舒張壓 (float—mmHg)
使用者在一段時間內的平均舒張血壓。
最高舒張壓 (float mmHg)
使用者在一段時間內的最高舒張血壓。
最低舒張壓 (float—mmHg)
使用者在一段時間內的最低舒張血壓。
身體位置 (int—列舉) (選填欄位)
測量時使用者的身體姿勢。
measurement location (int—enum) (選填欄位)
測量血壓的手臂和部位。

Android

名稱com.google.blood_pressure.summary
資料類型物件AGGREGATE_BLOOD_PRESSURE_SUMMARY
欄位 (格式:單位)
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
欄位 (格式:單位)
平均 (攝氏 float)
使用者在一段時間內的平均體溫。
max (float—攝氏)
使用者在一段時間內的最高體溫。
min (float—攝氏)
使用者在一段時間內的最低體溫。
measurement location (int—enum) (選填欄位)
測量體溫的部位。

Android

名稱com.google.body.temperature.summary
資料類型物件AGGREGATE_BODY_TEMPERATURE_SUMMARY
欄位 (格式:單位)
FIELD_AVERAGE (float—celsius)
使用者在一段時間內的平均體溫。
FIELD_MAX (float—celsius)
使用者在一段時間內的最高體溫。
FIELD_MIN (float—celsius)
使用者在一段時間內的最低體溫。
FIELD_BODY_TEMPERATURE_MEASUREMENT_LOCATION (int—列舉) (選用欄位)
測量體溫的部位。

血氧濃度摘要

每個資料點代表使用者在一段時間內的平均、最低和最高血氧濃度,以及輔助供氧流速。

如果時間範圍內所有測量結果的每個欄位值都相同,傳回的資料就會顯示該欄位值:

  • 氧氣治療管理模式
  • 血氧濃度系統
  • 血氧濃度測量方式

如果不同評估結果的值不同,系統會排除該欄位。

REST

名稱com.google.oxygen_saturation.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.oxygen_saturation.read
欄位 (格式:單位)
平均血氧濃度 (float—百分比)
使用者在一段時間內的平均血氧濃度。
最高血氧濃度 (float - 百分比)
使用者在一段時間內的最高血氧濃度。
最低血氧濃度 (float - 百分比)
使用者在一段時間內的最低血氧濃度。
平均補充氧氣流速 (float—公升/分鐘)
使用者在一段時間內的平均補充氧氣流速。
最高輔助氧氣流速 (float—L/min)
使用者在一段時間內的最高輔助供氧流速。
最低輔助氧氣流速 (float 公升/分鐘)
使用者在一段時間內的最低輔助供氧流速。
氧氣治療管理模式 (int—列舉) (選填欄位)
氧氣治療的給予方式。
如果透過鼻插管給藥,則可省略或設為 1
血氧濃度系統 (int 列舉) (選用欄位)
測量血氧濃度的位置。
如果是在周邊微血管中測量,則可能沒有或為 1
血氧濃度測量方法 (int 列舉) (選填欄位)
血氧濃度的測量方式。
如果透過脈搏血氧儀測量,則可能沒有或為 1

Android

名稱com.google.oxygen_saturation.summary
資料類型物件AGGREGATE_OXYGEN_SATURATION_SUMMARY
欄位 (格式:單位)
FIELD_OXYGEN_SATURATION_AVERAGE (float—百分比)
使用者在一段時間內的平均血氧濃度。
FIELD_OXYGEN_SATURATION_MAX (float百分比)
使用者在一段時間內的最高血氧濃度。
FIELD_OXYGEN_SATURATION_MIN (float—percentage)
使用者在一段時間內的最低血氧濃度。
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