这些数据类型可用于捕获活动、锻炼和锻炼相关指标。
Activity
此数据类型可用于捕获用户执行的任何活动。这可以是常见的健身活动(例如跑步或不同的运动),也可以是冥想、园艺和睡眠等活动。
如果用户在该时间段内进行了多项活动,请为主活动类型创建一个会话,并针对不同的活动类型创建多个细分。例如,如果他们在综合格斗课程期间进行了一些踢拳和拳击,可以创建一个综合格斗课程。然后,您可以将不同的活动类型细分为不同的细分。
每个数据点都需要有开始时间和结束时间。数据点无需连续或直接相邻,之间可能会存在差异。
REST
名称 | com.google.activity.segment |
OAuth 权限范围 |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
字段(格式 - 单位) | activity 类型(int - 枚举)
用户所进行活动的类型。请在此处查看活动类型列表。 |
Android
名称 | com.google.activity.segment |
数据类型对象 | TYPE_ACTIVITY_SEGMENT |
Android 权限 | ACTIVITY_RECOGNITION |
字段(格式 - 单位) | FIELD_ACTIVITY (int - 枚举)
用户所进行活动的类型。请在此处查看活动类型列表。 |
基础代谢率 (BMR)
此数据类型捕获用户的 BMR,以千卡路里为单位。每个数据点代表用户全天休息时消耗的千卡路里数,基于其身高和体重。只应设置结束时间。这将用作读取操作的时间戳。
REST
名称 | com.google.calories.bmr |
OAuth 权限范围 |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
字段(格式 - 单位) | 卡路里(float - 千卡/天)
用户全天休息时消耗的千卡路里数,基于身高和体重。 |
Android
名称 | com.google.calories.bmr |
数据类型对象 | TYPE_BASAL_METABOLIC_RATE |
字段(格式 - 单位) | FIELD_CALORIES(float - 千卡/天)
根据年龄、体重和身高计算的用户全天休息时可消耗的千卡路里数。 |
消耗卡路里数
此数据类型会捕获用户消耗的总卡路里数(以千卡路里为单位),包括休息时消耗的卡路里数 (BMR)。每个数据点代表一段时间内消耗的总千卡路里,因此开始时间和结束时间都应设置完毕。
REST
名称 | com.google.calories.expended |
OAuth 权限范围 |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
字段(格式 - 单位) | calories (float —kcal)
消耗千卡路里数。 |
Android
名称 | com.google.calories.expended |
数据类型对象 | TYPE_CALORIES_EXPENDED |
Android 权限 | ACTIVITY_RECOGNITION |
字段(格式 - 单位) | FIELD_CALORIES(float - 千卡)
消耗千卡路里数。 |
单车踩踏频率
如果用户骑车,此数据类型可用于捕获他们的踏板速度,以每分钟曲柄转数 (RPM) 为单位。每个数据点都代表着踏板速率的瞬时测量值,因此只需设置结束时间。这将用作读取操作的时间戳。
REST
名称 | com.google.cycling.pedaling.cadence |
OAuth 权限范围 |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
字段(格式 - 单位) | rpm (float -rpm)
自行车曲柄每分钟的转数。 |
Android
名称 | com.google.cycling.pedaling.cadence |
数据类型对象 | TYPE_CYCLING_PEDALING_CADENCE |
字段(格式 - 单位) | FIELD_RPM (float -rpm)
自行车曲柄每分钟的转数。 |
单车踏板累积量
如果用户骑车,此数据类型可用于捕获一段时间内的曲柄转数。每个数据点表示自开始计数后的转数。
REST
名称 | com.google.cycling.pedaling.cumulative |
OAuth 权限范围 |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
字段(格式 - 单位) | 转数(int - 计数)
一段时间内的自行车曲柄转数。 |
Android
名称 | com.google.cycling.pedaling.cumulative |
数据类型对象 | TYPE_CYCLING_PEDALING_CUMULATIVE |
字段(格式 - 单位) | FIELD_REVOLUTIONS(int - 计数)
一段时间内的自行车曲柄转数。 |
心肺强化分数
此数据类型会捕获用户通过所有活动获得的心肺强化分数。每个数据点代表针对相应时间间隔计算出的心肺强化分数。
用户可以设置每日心肺强化分数目标并追踪他们的进度。心肺强化分数的计算方式如下:
- 心率
- 任务代谢当量 (MET) 值
- 步行速度
获得的心肺强化分数取决于运动的强度。可以按照本指南计算和写入心肺强化分数:
数据 | 1 马力(低中强度活动) | 2 个 HP(高强度活动) |
---|---|---|
心率 | 以高于 50% 的最大心率进行活动 1 分钟 | 以 >70% 最大心率进行活动 1 分钟 |
MET 值 | 3-6 MET。例如划船或攀岩 | MET 高于 6。例如:高强度间歇训练 (HIIT)、滑雪、排球或足球。 |
步行速度 | 每分钟 100-130 步 | 每分钟>130 步 |
REST
名称 | com.google.heart_minutes |
OAuth 权限范围 |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
字段(格式 - 单位) | intenity(float - 心肺强化分数)
根据用户锻炼或活动的强度获得心肺强化分数。 |
Android
名称 | com.google.heart_minutes |
数据类型对象 | TYPE_HEART_MINUTES |
字段(格式 - 单位) | FIELD_INTENSITY(float - 心肺强化分数)
用户运动或活动的强度。进行 1 分钟轻度到中等体育活动(例如步行速度超过 2.5 英里/小时,或骑车速度超过 10 英里/小时)可获得 1 分心肺强化分数。进行 1 分钟更剧烈的运动可获得 2 分心肺强化分数。 |
活动时间
此数据类型会捕获 Google 健身计算的用户从所有活动中获得的活动分钟数。每个数据点都代表相应时间间隔内的“活动时间”派生分钟数。必须同时设置开始时间和结束时间。
用户可通过任何活动(例如瑜伽、舞蹈、园艺和其他家务)获得活动时间。如果他们进行散步,每当他们在 60 秒内走至少 30 步时,Google 健身就会奖励 1 分钟“活动分钟数”。
REST
名称 | com.google.active_minutes |
OAuth 权限范围 |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
字段(格式 - 单位) | duration(int - 毫秒)
获得的活动时间的时长(以毫秒为单位)。
有效范围:>=0 |
Android
名称 | com.google.active_minutes |
数据类型对象 | TYPE_MOVE_MINUTES |
字段(格式 - 单位) | FIELD_DURATION(int - 毫秒)
获得的活动时间的时长(以毫秒为单位)。
有效范围:0 - Long.MAX_VALUE |
功率
此数据类型捕获用户在执行活动时产生的电量,以瓦特为单位。例如,在固定自行车上锻炼时使用功率表。每个数据点都表示一个瞬时测量的发电量。
每个数据点都代表一个瞬时测量的发电量,因此只应设置结束时间。这将用作读取操作的时间戳。
REST
名称 | com.google.power.sample |
OAuth 权限范围 |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
字段(格式 - 单位) | 瓦特(float - 瓦特)
发电的功率(以瓦特为单位)。 |
Android
名称 | com.google.power.sample |
数据类型对象 | TYPE_POWER_SAMPLE |
字段(格式 - 单位) | FIELD_WATTS(float - 瓦特)
发电的功率(以瓦特为单位)。 |
步数统计频率
此数据类型可捕获步行频率,以每分钟步数为单位。每个数据点都代表对节奏的瞬时测量(以每分钟步数为单位)。
REST
名称 | com.google.step_count.cadence |
OAuth 权限范围 |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
字段(格式 - 单位) | rpm(float - 步数/分钟)
频率(以每分钟步数为单位)。 |
Android
名称 | com.google.step_count.cadence |
数据类型对象 | TYPE_STEP_COUNT_CADENCE |
字段(格式 - 单位) | FIELD_RPM(float - 步数/分钟)
频率(以每分钟步数为单位)。 |
步数增量
此数据类型捕获自上次读取后行走的步数。每个步骤仅报告一次,因此数据点的时间不应重叠。每个数据点的开始时间应表示行走间隔的开始时间。
开始时间必须等于或晚于上一个数据点的结束时间。将一段时间内的所有值相加即可计算该时间段内的总步数。
REST
名称 | com.google.step_count.delta | |
OAuth 权限范围 |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
|
字段(格式 - 单位) |
|
Android
名称 | com.google.step_count.delta | |
数据类型对象 | TYPE_STEP_COUNT_DELTA | |
Android 权限 | ACTIVITY_RECOGNITION | |
字段(格式 - 单位) |
|
运动
每个数据点都代表用户进行的一组连续锻炼运动。数据点包含运动类型(例如阻力运动或体重训练)、运动重复次数、运动时长和阻力的字段。
REST
名称 | com.google.activity.exercise | |||||
OAuth 权限范围 |
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
|
|||||
字段(格式 - 单位) |
|
Android
名称 | com.google.activity.exercise | |||||
字段(格式 - 单位) |
|