活動資料類型

這些資料類型可用於擷取運動相關的活動、健身課程和指標。

活動

這個資料類型可用於擷取使用者進行的任何活動。可用的值包括 常見健身活動，例如跑步或不同運動，以及 冥想、園藝和睡眠等活動。

如果使用者在該時間範圍內進行多項活動，請為主要活動類型建立工作階段，並為不同的活動類型建立多個區隔。舉例來說，如果他們在混合武術的表現，會稍微調整拳擊和拳擊 課程，建立混合武術的課程。再按 把活動類型劃分為區隔

每個資料點都需要開始時間和結束時間。資料點不必連續或緊接，中間可以有空白。

注意： 同一個串流資料點的時間範圍不得重疊！如果他們 會捨棄重疊時間範圍的資料 預期值和顯示值之間的差異

REST

名稱	com.google.activity.segment
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式：units)	activity type (int-enum) 使用者進行的活動類型。請參閱這裡的活動類型清單。

Android

名稱	com.google.activity.segment
資料類型物件	TYPE_ACTIVITY_SEGMENT
Android 權限	ACTIVITY_RECOGNITION
欄位 (format—unit)	FIELD_ACTIVITY (int，列舉) 使用者正在進行的活動類型。請參閱這裡的活動類型清單。

基礎代謝率 (BMR)

這個資料類型會擷取韓國境內使用者的 BMR。每個資料點代表使用者在整天休息時，根據身高和體重所燃燒的卡路里數。請只設定結束時間。這個 會做為讀取作業的時間戳記。

注意：Google Fit 會使用基礎代謝率來計算卡路里燃燒量。未顯示 在應用程式中直接開啟

REST

名稱	com.google.calories.bmr
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式：units)	卡路里 (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
欄位 (格式：units)	卡路里 (float—大卡) 燃燒的千卡路里數量。

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
欄位 (格式：units)	FIELD_RPM (float - rpm) 每分鐘單車刀轉數。

單車踩踏累積

如果使用者騎單車，這個資料類型可用來擷取 一段時間內 crank 革命。每個資料點都代表自開始時間起的轉數。

注意：每個資料點都會記錄自開始時間起的總轉數。這不是轉速的差異或變化。因此，您可以將結束時間的最終計數值減去開始時間的初始計數值，即可計算出某個時間間隔內的轉數。

REST

名稱	com.google.cycling.pedaling.cumulative
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式：units)	revolutions (int - 計數) 一段時間內的自行車曲柄轉數。

Android

名稱	com.google.cycling.pedaling.cumulative
資料類型物件	TYPE_CYCLING_PEDALING_CUMULATIVE
欄位 (格式：units)	FIELD_REVOLUTIONS (int—count) 一段時間內的單車鐵克革命數量。

心肺強化分數

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

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

• 心率
• 代謝當量 (MET) 值
• 步行速度

獲得的心肺強化分數取決於活動強度，使用 本指南說明如何計算及寫入心肺強化分數：

資料	1 HP (低至中強度活動)	2 HP (高強度活動)
心率	活動時間：1 分鐘，心率上限為 50%	以最大心率 >70% 進行活動 1 分鐘
MET 值	3-6 MET。例如划船或攀岩	> 6 MET。例如 HIIT、滑雪、排球或足球。
步行速度	每分鐘 100-130 步	每分鐘步數 >130 步

注意：您必須設定開始和結束時間。這些時間戳記必須向上或向下捨至最接近的整數分鐘，因此秒值一律應為 :00。

REST

名稱	com.google.heart_minutes
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式：units)	強度 (float—心率) 系統會根據使用者的運動或活動強度獲得心肺強化分數。

Android

名稱	com.google.heart_minutes
資料類型物件	TYPE_HEART_MINUTES
欄位 (格式 - 單位)	FIELD_INTENSITY (float—心點) 使用者進行的運動或活動的強度。每分鐘從事輕度到中等強度體能活動 (例如步行速度超過每小時 4 公里/每小時 2.5 英里，或騎乘自行車速度超過每小時 16 公里/每小時 10 英里) 可獲得 1 分心肺強化分數。延長 1 分鐘 高強度活動可獲得 2 點心肺強化分數。

活動時間 (分鐘)

這個資料類型會擷取 Google Fit 計算的活動時間 所獲得的收益。每個資料點都代表 某時間間隔的活動分鐘數。開始和結束時間都必須設定。

使用者透過任何活動 (例如瑜珈、跳舞或園藝) 都能獲得「活動時間」 和其他家庭家務如果使用者在散步時，每 60 秒內至少走 30 步，Google Fit 就會獎勵使用者 1 分鐘的 Move Minute。

注意：這些時間戳記必須向上或向下捨入至最接近的分鐘，因此秒值應一律為 :00。

REST

名稱	com.google.active_minutes
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式：units)	duration (int - 毫秒) 獲得的活動時間 (以毫秒為單位)。 有效範圍：>=0

Android

名稱	com.google.active_minutes
資料類型物件	TYPE_MOVE_MINUTES
欄位 (格式：units)	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
欄位 (格式：units)	瓦特 (float-瓦特) 產生的功率，以瓦特為單位。

Android

名稱	com.google.power.sample
資料類型物件	TYPE_POWER_SAMPLE
欄位 (格式：units)	FIELD_WATTS (float—瓦特) 產生的功率 (以瓦特為單位)。

步數計算頻率

這個資料類型會擷取步行頻率，以每分鐘步數測量。每項 代表著每 100 個 分鐘。

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

Android

名稱	com.google.step_count.delta
資料類型物件	TYPE_STEP_COUNT_DELTA
Android 權限	ACTIVITY_RECOGNITION
欄位 (格式：units)	TYPE_STEP_COUNT_DELTA (int，計數) 一段時間內的步數。 有效範圍：每秒 0 至 10 步

健身

每個資料點代表使用者執行的單一連續健身運動組合。資料點包含運動類型 ( 阻力運動或重量訓練範例)、重複次數 運動、運動時間和阻力。

REST

名稱	com.google.activity.exercise
OAuth 權限範圍	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
欄位 (格式：units)	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 repetitions (int，列舉) 運動的重複次數。 resistance type (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 到 kg) 運動 (或體重) 的阻力，以公斤為單位。 duration (int - 毫秒) 運動時間長度。

Android

名稱

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-數量) 運動重複次數。 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 至 kg) 運動的阻力 (或重量)，以公斤為單位。 FIELD_DURATION (int - 毫秒) 運動時間長度。