活動資料類型

這些資料類型可用於擷取有關運動的活動、運動和指標。

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 type (int：列舉) 使用者進行的活動類型。請參閱活動類型清單。

Android

Name	com.google.activity.segment
資料類型物件	TYPE_ACTIVITY_SEGMENT
Android 權限	ACTIVITY_RECOGNITION
欄位 (格式 - 單位)	FIELD_activity(int：列舉) 使用者進行的活動類型。請參閱活動類型清單。

基礎代謝率 (BMR)

這個資料類型可擷取使用者的 BMR (千焦耳)。每個資料點代表使用者一整天休息時消耗的千焦耳數量，根據其身高和體重計算。只能設定結束時間。這會做為讀取作業的時間戳記。

注意：Google Fit 會使用 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：每天 kcal) 使用者一天當中休息時消耗的卡路里數，根據年齡、體重和身高而定。

卡路里燃燒量

這個資料類型會擷取使用者燃燒的總卡路里 (以千焦耳為單位)，包括靜態燃燒的卡路里 (BMR)。每個資料點代表在特定時間間隔內燃燒的總卡路里，因此必須設定開始和結束時間。

注意：撰寫卡路里資料時，請納入休息時的卡路里燃燒量 (使用者的 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) 的踩踏率。每個資料點代表了踩踏率的即時測量，因此只能設定結束時間。這會做為讀取作業的時間戳記。

注意：計算即時 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
欄位 (格式 - 單位)	rturns (int：計數) 特定時間範圍內的單車曲柄數量。

Android

Name	com.google.cycling.pedaling.cumulative
資料類型物件	TYPE_CYCLING_PEDALING_CUMULATIVE
欄位 (格式 - 單位)	FIELD_REVOLUTIONS (int—count) 特定時間範圍內的單車曲柄數量。

心肺強化分數

這個資料類型會從使用者的所有活動中擷取使用者獲得的心肺強化分數。每個資料點代表在某個時間間隔中計算的心肺強化分數。

使用者可以設定每日心肺強化分數目標並追蹤進度。「分數」的計算方式如下：

• 心跳速率
• 同等的任務代謝 (MET) 值
• 步行速度

獲得的心肺強化分數取決於活動強度。請使用這份指南計算及寫入心肺強化分數：

Data	1 HP (中等強度強度活動)	2 HP (高強度活動)
心率	心率為 1 分鐘，最高心率為 50%	1 分鐘活動量：最大心率 70%
MET 值	3 至 6 小時。例如划船或攀岩，	>6 MET。例如高強度間歇訓練 (HIIT)、滑雪、打排球或足球
步行速度	每分鐘 100 到 130 步	>每分鐘 130 步

注意：請務必設定開始和結束時間。這些時間戳記必須四捨五入至最接近的分鐘數，因此秒數值應一律為 :00。

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：心率) 使用者運動或活動的強度。一分鐘的中度光線可以適度從事身體活動 (例如步行速度超過 2.5 英里/小時，或騎自行車速度超過 10 英里)，即可獲得 1 分。一分鐘的高強度運動可獲得 2 分。

活動時間 (分鐘)

這個資料類型可擷取 Google Fit 根據使用者的所有活動計算得出的「活動時間」(分鐘)。每個資料點代表一個時間間隔內的衍生移動時間。必須設定開始和結束時間。

使用者可以從任何活動 (例如瑜珈、跳舞或園藝和其他家常) 賺取活動分鐘數。如果使用者要走路，Google Fit 會在 60 秒內每走 30 步以上，就會記錄一次移動分鐘數。

注意：這些時間戳記必須四捨五入至最接近的分鐘數，因此秒數的值一律須為 :00。

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
欄位 (格式 - 單位)	watts (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
欄位 (格式 - 單位)	steps (int --count) 指定時間範圍內的步數。 有效範圍：每秒 0 至 10 步

Android

Name	com.google.step_count.delta
資料類型物件	TYPE_STEP_COUNT_DELTA
Android 權限	ACTIVITY_RECOGNITION
欄位 (格式 - 單位)	TYPE_STEP_COUNT_DELTA (int—計數) 指定時間範圍內的步數。 有效範圍：每秒 0 至 10 步

健身

每個資料點都代表使用者連續進行的一組健身運動。資料點包含運動類型的欄位 (例如阻力運動或重量訓練)、運動重複次數、運動時間長度和阻力。

REST

Name	com.google.activity.exercise
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式 - 單位)	exercise (int：列舉) 代表不同運動的值，例如重量訓練、力量訓練運動和心血管運動。 接受的值 back_extension bridge.hip.single_leg burpee calf_press calf_raise calf_raise.seated calf_raise.standing chinup clean clean.hang clean.hang_power clean.jerk clean.power crunch crunch.twisting curl.bicep deadlift deadlift.rdl deadlift.single_leg deadlift.straight_leg dip dip.chest dip.triceps fly good_morning hip_extension hip_raise hip_thrust jumping_jack leg_curl leg_extension leg_press leg_raise lunge lunge.rear lunge.side plank plank.side press.bench press.bench.close_grip press.bench.decline press.bench.incline press.jm press.pike press.shoulder press.shoulder.arnold press.shoulder.military pulldown pullover pullup pushup pushup.close_grip pushup.pike raise.front raise.lateral raise.lateral.rear row row.high row.upright run.high_knee russian_twist shrug situp situp.twisting squat step_up swing thruster triceps_extension vups wall_sit rereps (int：列舉) 運動的重複次數。 resistance 類型 (int：列舉) 運動期間使用的阻力類型。 接受的值 "intVal": 0 // The resistance type is unknown, unspecified, or can't be represented by a value. "intVal": 1 // The user is using a barbell for resistance. "intVal": 2 // The user is using a cable for resistance. If using 2 cables are used (one for each arm), include the resistance weight for one arm. "intVal": 3 // The user is using dumbells for resistance. "intVal": 4 // The user is using a kettlebell for resistance "intVal": 5 // The user is performing the exercise in a machine. "intVal": 6 // The user is using their own body weight for resistance. 阻力 (float - 公斤) 運動的強度 (或體重)，以公斤為單位。 duration (int - 毫秒) 持續運動的時間。

Android

Name

com.google.activity.exercise

欄位 (格式 - 單位)

FIELD_EXERCISE (int—列舉) 代表不同運動的值，例如重量訓練、力量訓練運動和心血管運動。 接受的值 ARNOLD_PRESS BACK_EXTENSION BENCH_PRESS BICEP_CURL BURPEE CALF_PRESS CALF_RAISE CHEST_DIP CHINUP CLEAN CLEAN_JERK CLOSE_GRIP_BENCH_PRESS CLOSE_GRIP_PUSHUP CRUNCH DEADLIFT DECLINE_BENCH_PRESS DIP FLY FRONT_RAISE GOOD_MORNING HANG_CLEAN HANG_POWER_CLEAN HIGH_KNEE_RUN HIGH_ROW HIP_EXTENSION HIP_RAISE HIP_THRUST INCLINE_BENCH_PRESS JM_PRESS JUMPING_JACK LATERAL_RAISE LEG_CURL LEG_EXTENSION LEG_PRESS LEG_RAISE LUNGE MILITARY_PRESS PIKE_PRESS PIKE_PUSHUP PLANK POWER_CLEAN PULLDOWN PULLOVER PULLUP PUSHUP RDL_DEADLIFT REAR_LATERAL_RAISE REAR_LUNGE ROW RUSSIAN_TWIST SEATED_CALF_RAISE SHOULDER_PRESS SHRUG SIDE_LUNGE SIDE_PLANK SINGLE_LEG_DEADLIFT SINGLE_LEG_HIP_BRIDGE SITUP SQUAT STANDING_CALF_RAISE STEP_UP STRAIGHT_LEG_DEADLIFT SWING THRUSTER TRICEPS_DIP TRICEPS_EXTENSION TWISTING_CRUNCH TWISTING_SITUP UPRIGHT_ROW V_UPS WALL_SIT FIELD_REPETITIONS (int—count) 運動的重複次數。 FIELD_RESISTANCE_TYPE (int：列舉) 運動期間使用的阻力類型。 接受的值 RESISTANCE_TYPE_UNKNOWN // The resistance type is unknown, unspecified, or can't be represented by a value. RESISTANCE_TYPE_BARBELL // The user is using a barbell for resistance. RESISTANCE_TYPE_CABLE // The user is using a cable for resistance. If using 2 cables are used (one for each arm), include the resistance weight for one arm. RESISTANCE_TYPE_DUMBBELL // The user is using dumbells for resistance. RESISTANCE_TYPE_KETTLEBELL // The user is using a kettlebell for resistance RESISTANCE_TYPE_MACHINE // The user is performing the exercise in a machine. RESISTANCE_TYPE_BODY // The user is using their own body weight for resistance. FIELD_RESISTANCE (float - 公斤) 運動的強度 (或體重)，以公斤為單位。 FIELD_DURATION (int - 毫秒) 持續運動的時間。