匯總資料類型

如果資料可以持續記錄 (在特定時間範圍內有多個資料點),Google Fit 平台可以匯總這項資料,並傳回計算結果。這可以是平均測量或摘要/總計。透過讀取匯總資料,您可以節省這些計算時間,並方便應用程式使用者查看實用的摘要或平均值。

如要讀取匯總資料,您必須挑選資料類型和時間範圍,並將資料提供給 'bucket' (或分組) 資料。您可以透過下列幾種方式將值區資料分類:

時間範圍
按小時或每天劃分的匯總資料。例如每天查看步數或卡路里燃燒量。
活動類型
按活動類型劃分的值區匯總資料。以過去一週的睡眠資料為例,每個睡眠活動類型 (淺色、深度和 REM) 都有一個值區。
活動區隔
依時間範圍顯示活動區隔的匯總資料。舉例來說,如果使用者在上午 9 點到早上 10 點之間執行,但前 20 分鐘跑了,接著停 10 分鐘,步行 15 分鐘,執行 15 分鐘,這 4 個活動區隔就會計為 4 個值區。
Session
使用工作階段時間範圍來匯總資料。例如,如果使用者執行了 2 次跑步,分別記錄為 2 次工作階段 (早上跑步和下午跑步),您可以按工作階段分組,瞭解每次跑步的平均步數或平均速度。

Activity

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

活動摘要

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

REST

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

Android

Namecom.google.activity.summary
資料類型物件AGGREGATE_activity_SUMMARY
欄位 (格式 - 單位)
FIELD_activity (int:列舉)
使用者進行的活動類型。請參閱活動類型清單
FIELD_DURATION (int - 毫秒)
時間範圍內所有區隔的活動總時間。
FIELD_NUM_SEGMENTS (int—計數)
這個資料點在一段時間內的不同活動區隔數量。

基礎代謝率 (BMR) 摘要

每個資料點代表使用者在特定時間範圍內的平均值、最大和最小基礎代謝率 (以千焦耳為單位)。如果使用者獲得或減重,且 BMR 已經變更,這個方法就非常實用。

REST

Namecom.google.calories.bmr.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.activity.read
欄位 (格式 - 單位)
平均 (float - 每日)
使用者在特定時間範圍內的平均 BMR。
max (float - 每天 kcal)
使用者在特定時間範圍內的最大 BMR。
min (float - 每天 kcal)
使用者在特定時間範圍內的最低 BMR。

Android

Namecom.google.calories.bmr.summary
資料類型物件AGGREGATE_BASAL_METABOLIC_RATE_SUMMARY
欄位 (格式 - 單位)
FIELD_AVERAGE (float-每天 kcal)
使用者在特定時間範圍內的平均 BMR。
FIELD_MAX (float - 每日 Kcal)
使用者在特定時間範圍內的最大 BMR。
FIELD_MIN (float - 每日卡路里)
使用者在特定時間範圍內的最低 BMR。

卡路里燃燒量摘要

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

心肺強化分數

每個資料點代表在特定時間範圍內獲得的心肺強化分數。

REST

Namecom.google.heart_minutes.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.activity.read
欄位 (格式 - 單位)
強度 (float:心肺強化分數)
指定時間範圍內獲得的心肺強化分數,包括乘數獲得的點數 (從高強度活動獲得的積分)。
duration (float - 分)
獲得心肺強化分數的時間 (以分鐘為單位)。

Android

Namecom.google.heart_minutes.summary
資料類型物件AGGREGATE_HEART_POINTS
欄位 (格式 - 單位)
FIELD_INTENSITY (float:心肺強化分數)
指定時間範圍內獲得的心肺強化分數,包括乘數獲得的點數 (從高強度活動獲得的積分)。
FIELD_DURATION (float - 分鐘)
獲得心肺強化分數的時間 (以分鐘為單位)。

活動時間摘要

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

電源摘要

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

REST

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

Android

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

步數計數差異摘要

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

內文

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

體脂肪百分比摘要

每個資料點代表使用者在特定時間範圍內的平均值、最大和最小體脂肪百分比。

REST

Namecom.google.body.fat.percentage.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.body.read
欄位 (格式 - 單位)
平均 (float - 百分比)
使用者在指定時間範圍內的體脂肪總體平均百分比。
max (float - 百分比)
使用者在指定時間範圍內的體脂肪總體百分比上限。
min (float—percent)
使用者在指定時間範圍內的體脂肪總體最低百分比。

Android

Namecom.google.body.fat.percentage.summary
資料類型物件AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
欄位 (格式 - 單位)
FIELD_AVERAGE (float–percent)
使用者在指定時間範圍內的體脂肪總體平均百分比。
FIELD_MAX (float - 百分比)
使用者在指定時間範圍內的體脂肪總體百分比上限。
FIELD_MIN (float - 百分比)
使用者在指定時間範圍內的體脂肪總體最低百分比。

心率摘要

每個資料點代表使用者在特定時間範圍內的心跳速率、最大和最小心率 (以每分鐘心跳為單位)。

REST

Namecom.google.heart_rate.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.body.read
欄位 (格式 - 單位)
平均 (float - bpm)
使用者在特定時間範圍內的心跳速率 (以每分鐘心跳為單位)。
max (float - bpm)
使用者在特定時間範圍內的心跳速率 (以每分鐘心跳為單位)。
min (float - bpm)
使用者在一段時間內以最低心跳為單位的最小心率。

Android

Namecom.google.heart_rate.summary
資料類型物件AGGREGATE_HEART_RATE_SUMMARY
欄位 (格式 - 單位)
FIELD_AVERAGE (float-bpm)
使用者在特定時間範圍內的心跳速率 (以每分鐘心跳為單位)。
FIELD_MAX (float-bpm)
使用者在特定時間範圍內的心跳速率 (以每分鐘心跳為單位)。
FIELD_MIN (float - bpm)
使用者在一段時間內以最低心跳為單位的最小心率。

高度摘要

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

REST

Namecom.google.height.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.body.read
欄位 (格式 - 單位)
平均 (float - 公尺)
使用者在特定時間範圍內的平均高度 (以公尺為單位)。
max (float - 公尺)
使用者在特定時間範圍內的最大高度 (以公尺為單位)。
min (float - 公尺)
使用者在特定時間範圍內的最小高度 (以公尺為單位)。

Android

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

體重摘要

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

REST

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

Android

Namecom.google.weight.summary
資料類型物件AGGREGATE_WEIGHT_SUMMARY
欄位 (格式 - 單位)
FIELD_AVERAGE (float—kg)
使用者在特定時間範圍內的平均體重 (以公斤為單位)。
FIELD_MAX (float - 公斤)
使用者在指定時間範圍內的體重上限 (以公斤為單位)。
FIELD_MIN (float - 公斤)
使用者在特定時間範圍內的最小體重 (以公斤為單位)。

位置

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

距離差異

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

位置定界框

每個資料點代表在一段時間內針對使用者位置計算的定界框。每個定界框都有四個欄位,代表定界框的四個角落。

REST

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

Android

Namecom.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

Namecom.google.speed.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.location.read
欄位 (格式 - 單位)
平均 (float - 每秒公尺)
使用者在特定時間範圍內的平均速度 (以公尺/秒為單位)。
max (float - 每秒公尺)
使用者在特定時間範圍內的最大速度 (以公尺/秒為單位)。
min (float:每秒公尺)
使用者在特定時間範圍內的最小速度 (以公尺/秒為單位)。

Android

Namecom.google.speed.summary
資料類型物件AGGREGATE_SPEED_SUMMARY
欄位 (格式 - 單位)
平均 (float - 每秒公尺)
使用者在特定時間範圍內的平均速度 (以公尺/秒為單位)。
max (float - 每秒公尺)
使用者在特定時間範圍內的最大速度 (以公尺/秒為單位)。
min (float:每秒公尺)
使用者在特定時間範圍內的最小速度 (以公尺/秒為單位)。

營養

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

飲水量摘要

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

營養摘要

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

如果任何參賽者中都沒有營養記錄,它們也不會在匯總對應中。如果這個時間範圍內所有項目皆適用於相同的餐點,則會一併設定餐飲類型。

REST

Namecom.google.nutrition.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.nutrition.read
欄位 (格式 - 單位)
meal type (int:列舉)
使用者吃的餐點種類 (如果時間範圍中的所有項目都針對同餐)。
營養素 (Map<String>:卡路里/公克)
指定期間內飲食的營養總量。

Android

Namecom.google.nutrition.summary
資料類型物件AGGREGATE_NUTRITION_SUMMARY
欄位 (格式 - 單位)
FIELD_MEAL_TYPE (int—列舉)
使用者吃的餐點種類 (如果時間範圍中的所有項目都針對同餐)。
FIELD_NUTRIENTS (Map<String>:千焦耳/公克/毫克)
指定期間內飲食的營養總量。

醫療保健

這些資料類型可用於讀取匯總的醫療健康資料。

血糖摘要

每個資料點代表的平均值、最小和最大血糖水平或時間範圍內的測量值 (以 mmol/L 為單位),1 mmol/L 為 18 mg/dL。

如果在時間範圍內時間範圍內的所有測量結果,這些欄位的值都相同,則傳回的資料中會顯示的欄位值:

  • 與餐點的關係
  • 時間關係與睡眠
  • 樣本來源

如果測量結果中的值不同,系統會排除該欄位。

REST

Namecom.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)
使用者在特定時間範圍內的最低血糖水平或濃度。
temporal 與 meal 的關係 (int—列舉) (選用欄位)
測量時間
meal type (int:列舉) (選用欄位)
使用者朗讀書籍時須吃哪一類餐點。
暫時睡眠關係 (int:列舉) (選用欄位)
測量時間是使用者睡眠的時間。
樣本來源 (int:列舉) (選用欄位)
用於測量血糖的體液類型。

Android

Namecom.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 - 列舉) (選填欄位)
測量時間
FIELD_MEAL_TYPE (int - 列舉) (選填欄位)
使用者朗讀書籍時須吃哪一類餐點。
FIELD_TEMPORAL_RELATION_TO_SLEEP (int—列舉) (選用欄位)
測量時間是使用者睡眠的時間。
FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE (int:列舉) (選填欄位)
用於測量血糖的體液類型。

血壓摘要

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

如果在時間範圍內時間範圍內的所有測量結果,這些欄位的值都相同,則傳回的資料中會顯示的欄位值:

  • 身體位置
  • 評估位置

如果測量結果中的值不同,系統會排除該欄位。

REST

Namecom.google.blood_pressure.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.blood_pressure.read
欄位 (格式 - 單位)
平均收縮壓 (float—mmHg)
使用者一段時間內的平均收縮血壓。
收縮壓上限 (float - mmHg)
使用者在一段時間內的最大收縮血壓。
min systolic (float - mmHg)
使用者在一段時間內的最低收縮血壓。
平均舒張壓 (float - mmHg)
使用者一段時間內的平均舒張壓血壓。
最大舒張壓 (float—mmHg)
使用者在特定時間範圍內的舒張壓血壓。
min 舒張壓 (float - mmHg)
使用者在特定時間範圍內的舒張壓血壓。
body position (int - 列舉) (選用欄位)
測量時的主體位置。
measurement location (int - 列舉) (選用欄位)
測量的是哪個實驗組和哪一組。

Android

Namecom.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

Namecom.google.body.temperature.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.body_temperature.read
欄位 (格式 - 單位)
平均 (float - 攝氏)
使用者在特定時間範圍內的平均體溫。
max (float - 攝氏)
使用者在指定時間範圍內的最高體溫。
min (float:攝氏)
使用者在指定時間範圍內的最低體溫。
measurement location (int - 列舉) (選用欄位)
測量溫度的來源位於使用者的身體上。

Android

Namecom.google.body.temperature.summary
資料類型物件AGGREGATE_BODY_TEMPERATURE_SUMMARY
欄位 (格式 - 單位)
FIELD_AVERAGE (float—攝氏)
使用者在特定時間範圍內的平均體溫。
FIELD_MAX (float - 攝氏)
使用者在指定時間範圍內的最高體溫。
FIELD_MIN (float - 攝氏)
使用者在指定時間範圍內的最低體溫。
FIELD_BODY_TEMPERATURE_MEASUREMENT_LOCATION (int—列舉) (選用欄位)
測量溫度的來源位於使用者的身體上。

血氧濃度摘要

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

如果在時間範圍內時間範圍內的所有測量結果,這些欄位的值都相同,則傳回的資料中會顯示的欄位值:

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

如果測量結果中的值不同,系統會排除該欄位。

REST

Namecom.google.oxygen_saturation.summary
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.oxygen_saturation.read
欄位 (格式 - 單位)
平均氧飽和度 (float—百分比)
使用者在指定時間範圍內的平均氧飽和度。
最高氧飽和度 (float—百分比)
使用者在指定時間範圍內的最大氧飽和度。
最小氧飽和度 (float—百分比)
使用者在指定時間範圍內的氧氣飽和度最低。
平均補充氧氣流率 (float—L/min)
使用者在特定時間範圍內的平均補充氧氣流量。
最高氧氣流速 (float—L/min)
使用者在特定時間範圍內的最大補充氧氣流速率。
min 補充氧氣流量 (float—L/min)
使用者在特定時間範圍內的最低氧氣流量。
氧氣治療管理模式 (int:列舉) (選用欄位)
氧氣療法的管理方式。
可以用1
血氧飽和度系統 (int—列舉) (選用欄位)
測量血氧濃度的位置。
如果不是在周邊裝置中使用,則為 1
血氧飽和度測量方法 (int—列舉) (選用欄位)
氧飽和度的測量方式。
如果透過脈搏血氧儀測量,可以留空或 1

Android

Namecom.google.oxygen_saturation.summary
資料類型物件AGGREGATE_OXYGEN_SATURATION_SUMMARY
欄位 (格式 - 單位)
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/分鐘)
使用者在特定時間範圍內的最大補充氧氣流速率。
FIELD_SUPPLEMENTAL_OXYGEN_FLOW_RATE_MIN (float - L/分鐘)
使用者在特定時間範圍內的最低氧氣流量。
FIELD_OXYGEN_THERAPY_ADMINISTRATION_MODE (int—列舉) (選用欄位)
氧氣療法的管理方式。
可以用1
FIELD_OXYGEN_SATURATION_SYSTEM (int—列舉) (選用欄位)
測量血氧濃度的位置。
如果不是在周邊裝置中使用,則為 1
FIELD_OXYGEN_SATURATION_MEASUREMENT_ Method (int:列舉) (選填欄位)
氧飽和度的測量方式。
如果透過脈搏血氧儀測量,可以留空或 1