汇总数据类型

适用于可以连续记录的数据（在一段时间内有多个数据点） Google 健身平台可汇总这些数据并返回 计算结果。这可以是平均测量值或汇总值/总计值。您 可以节省计算时间，并向应用用户展示实用的摘要或 轻松计算平均值。

若要读取汇总数据，您需要选择数据类型、时间范围等 更改为“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
字段（格式 - 单位）
activity（int - 枚举）
用户正在执行的操作的类型。点击此处查看活动类型列表。
duration（int - 毫秒）
选定时间范围内所有细分中某一项活动的总时间。
片段数量（int—计数）
此数据点的时间间隔内不同活动细分的数量。

Android

名称com.google.activity.summary
数据类型对象AGGREGATE_ACTIVITY_SUMMARY
字段（格式 - 单位）
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
字段（格式 - 单位）
平均（float - 千卡/天）
用户在一段时间内的平均 BMR。
max（float—千卡/天）
用户在一段时间内的最高 BMR。
min（float-千卡/天）
用户在一段时间内的最低 BMR。

Android

名称com.google.calories.bmr.summary
数据类型对象AGGREGATE_BASAL_METABOLIC_RATE_SUMMARY
字段（格式 - 单位）
FIELD_AVERAGE（float - 千卡/天）
用户在一段时间内的平均 BMR。
FIELD_MAX（float - 千卡/天）
用户在一段时间内的最高 BMR。
FIELD_MIN（float - 千卡/天）
用户在一段时间内的最低 BMR。

消耗卡路里数摘要

一段时间内消耗的卡路里总数或消耗的总卡路里数（以千卡路里为单位）。 此数据类型及其字段与用于瞬时数据 type。

心肺强化分数摘要

每个数据点都表示相应时间段内获得的心肺强化分数。

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 - 瓦特）
用户在一段时间内的平均发电量（以瓦特为单位）。
max（float - 瓦特）
用户在一段时间内的最大发电量（以瓦特为单位）。
min（float - 瓦特）
用户在一段时间内的最低发电量（以瓦特为单位）。

Android

名称com.google.power.summary
数据类型对象AGGREGATE_POWER_SUMMARY
字段（格式 - 单位）
FIELD_AVERAGE（float - 瓦特）
用户在一段时间内的平均发电量（以瓦特为单位）。
FIELD_MAX（float - 瓦特）
用户在一段时间内的最大发电量（以瓦特为单位）。
FIELD_MIN（float - 瓦特）
用户在一段时间内的最低发电量（以瓦特为单位）。

步数增量摘要

每个数据点都表示相应时间段内的总步数。 此数据类型及其字段与用于瞬时数据 type。

正文

使用这些数据类型来读取汇总的身体测量数据。

体脂百分比汇总

每个数据点代表用户的平均、最大和最小体脂百分比 一段时间内的变化

REST

名称com.google.body.fat.percentage.summary
OAuth 权限范围
https://www.googleapis.com/auth/fitness.body.read
字段（格式 - 单位）
average（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)
用户在一段时间内的平均心率（每分钟心跳次数）。
max (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
字段（格式 - 单位）
average（float - 米）
用户在一段时间内的平均身高，以米为单位。
max（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-kg)
用户在一段时间内的平均体重，以公斤为单位。
max (float-kg)
用户在一段时间内的最大体重，以公斤为单位。
分钟 (float-kg)
用户在一段时间内的最低体重，以公斤为单位。

Android

名称com.google.weight.summary
数据类型对象AGGREGATE_WEIGHT_SUMMARY
字段（格式 - 单位）
FIELD_AVERAGE（float - 千克）
用户在一段时间内的平均体重，以公斤为单位。
FIELD_MAX（float - 千克）
用户在一段时间内的最大体重，以公斤为单位。
FIELD_MIN（float - 千克）
用户在一段时间内的最低体重，以公斤为单位。

位置

使用这些数据类型读取汇总的位置数据。

距离增量

每个数据点都代表用户在一段时间内的出行总里程 时间段（以米为单位）。此数据类型及其字段与 瞬时数据类型：

位置边界框

每个数据点都代表 根据用户的 一段时间内的位置点每个边界框有四个字段 代表边界框的四个角。

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
字段（格式 - 单位）
average（float - 米/秒）
用户在一段时间内的平均速度（以米/秒为单位）。
max（float - 米/秒）
用户在一段时间内的最大速度（以米/秒为单位）。
min（float - 米/秒）
用户在一段时间内的最低速度（米/秒）。

Android

名称com.google.speed.summary
数据类型对象AGGREGATE_SPEED_SUMMARY
字段（格式 - 单位）
average（float - 米/秒）
用户在一段时间内的平均速度（以米/秒为单位）。
max（float - 米/秒）
用户在一段时间内的最大速度（以米/秒为单位）。
min（float - 米/秒）
用户在一段时间内的最低速度（米/秒）。

营养

使用这些数据类型来读取汇总的营养数据。

饮水量摘要

每个数据点都表示用户在 时间段（以升为单位）。此数据类型及其字段与 瞬时数据类型：

营养摘要

每个数据点代表某个时间段内所有营养条目的总和。 在 nutrients 字段中，每个值表示营养成分占所有营养素的总和 该时间段内的条目数

如果该营养素未出现在任何条目中，就不会出现在聚合映射中 。如果时间段中的所有条目都针对同一餐点，则餐点类型 。

REST

名称com.google.nutrition.summary
OAuth 权限范围
https://www.googleapis.com/auth/fitness.nutrition.read
字段（格式 - 单位）
膳食类型（int - 枚举）
用户吃了哪种餐点（如果时间段中的所有条目都属于同一餐点，则此条目存在）。
nutrients（Map<String> - 卡路里/克）
一段时间内食物摄入的营养素总量。

Android

名称com.google.nutrition.summary
数据类型对象AGGREGATE_NUTRITION_SUMMARY
字段（格式 - 单位）
FIELD_MEAL_TYPE（int - 枚举）
用户吃了哪种餐点（如果时间段中的所有条目都属于同一餐点，则此条目存在）。
FIELD_NUTRIENTS（Map<String> - 千卡路里/克/毫克）
一段时间内食物摄入的营养素总量。

健康

使用这些数据类型来读取汇总的医疗和健康数据。

血糖总结

每个数据点代表平均、最低和最高血糖水平 或指定时间范围内的浓度，以毫摩尔/升为单位，其中 1 毫摩尔/升为 18 毫克/分升。

如果这些字段的值在进行的所有测量中都相同 在时间范围内，您会在返回的数据中看到该字段值：

  • 饮食的时间关系
  • 与睡眠的时间关系
  • 样本来源

如果各测量值的值不同，则排除该字段。

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 - 毫摩尔/升）
用户在一段时间内的最低血糖水平或浓度。
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
字段（格式 - 单位）
平均收缩压 (float-mmHg)
用户在一段时间内的平均收缩压。
最大收缩压 (float-mmHg)
用户在一段时间内的最大收缩压。
最低收缩压 (float-mmHg)
用户在一段时间内的最低收缩压。
平均舒张压 (float—mmHg)
用户在一段时间内的平均舒张压。
最大舒张压 (float-mmHg)
用户在一段时间内的最大舒张压。
最低舒张压 (float-mmHg)
用户在一段时间内的最低舒张压。
body position（int - 枚举）（选填字段）
进行测量时用户的身体位置。
measurement location（int - 枚举）（选填字段）
进行测量的手臂和手臂的哪部分。

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
字段（格式 - 单位）
average（float - 摄氏度）
用户在一段时间内的平均体温。
max（float - 摄氏度）
用户在一段时间内的最高体温。
min（float - 摄氏度）
用户在一段时间内的最低体温。
measurement location（int - 枚举）（选填字段）
测量体温时所依据的用户身体部位。

Android

名称com.google.body.temperature.summary
数据类型对象AGGREGATE_BODY_TEMPERATURE_SUMMARY
字段（格式 - 单位）
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
字段（格式 - 单位）
平均血氧饱和度（float—百分比）
用户在一段时间内的平均血氧饱和度。
最高氧饱和度（float—百分比）
用户在一段时间内的最高血氧饱和度。
最低氧饱和度（float - 百分比）
用户在一段时间内的最低血氧饱和度。
平均补充供氧流速 (float—L/min)
用户在一段时间内的平均补充供氧流速。
最大补充供氧流速 (float—L/min)
用户在一段时间内的最大补充供氧流速。
最低补充供氧流速 (float—L/min)
用户在一段时间内的最低补充供氧流速。
氧疗法给药模式（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 - 百分比）
用户在一段时间内的最低血氧饱和度。
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 - 枚举）（选填字段）
氧治疗的执行方式。
如果通过鼻导管给药，该病可能缺失或 1。
FIELD_OXYGEN_SATURATION_SYSTEM（int - 枚举）（选填字段）
测量血氧饱和度的位置。
如果在外周毛细血管中测量，则可能缺失或 1。
FIELD_OXYGEN_SATURATION_MEASUREMENT_METHOD（int - 枚举）（选填字段）
如何测量血氧饱和度。
如果通过脉搏血氧测量测量，则可能缺失或 1。