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