활동 데이터 유형

이러한 데이터 유형은 활동, 운동, 운동 관련 측정항목을 캡처하는 데 사용할 수 있습니다.

활동

이 데이터 유형은 사용자가 수행하는 모든 활동을 캡처하는 데 사용할 수 있습니다. 달리기나 다양한 스포츠와 같은 일반적인 피트니스 활동은 물론 명상, 정원 가꾸기, 수면과 같은 활동도 포함될 수 있습니다.

사용자가 해당 기간에 두 개 이상의 활동을 한 경우 기본 활동 유형의 세션과 여러 활동 유형의 세그먼트를 만듭니다. 예를 들어 종합 격투기 수업 중에 킥복싱과 복싱을 조금 했다면 종합 격투기 세션을 만듭니다. 그런 다음 다양한 활동 유형을 세그먼트로 분류할 수 있습니다.

각 데이터 포인트에는 시작 시간과 종료 시간이 필요합니다. 데이터 포인트가 연속되거나 바로 뒤에 올 필요는 없으며, 사이에 간격이 있을 수 있습니다.

참고: 동일한 스트림의 데이터 포인트 시간 범위는 중복되지 않아야 합니다. 이 경우 중복 기간의 데이터가 삭제되어 예상 값과 표시된 값 간에 불일치가 발생할 수 있습니다.

REST

이름	com.google.activity.segment
OAuth 권한 범위	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
필드 (형식—단위)	활동 유형 (int—열거형) 사용자가 수행한 활동의 유형입니다. 여기에서 활동 유형 목록을 확인하세요.

Android

이름	com.google.activity.segment
데이터 유형 객체	TYPE_ACTIVITY_SEGMENT
Android 권한	ACTIVITY_RECOGNITION
필드 (형식-단위)	FIELD_ACTIVITY (int—enum) 사용자가 수행한 활동의 유형입니다. 여기에서 활동 유형 목록을 확인하세요.

기초 대사율 (BMR)

이 데이터 유형은 사용자의 기초대사량을 킬로칼로리로 나타냅니다. 각 데이터 포인트는 키와 체중을 기준으로 사용자가 하루 종일 휴식을 취할 때 소모하는 킬로칼로리 수를 나타냅니다. 종료 시간만 설정해야 합니다. 이 값은 읽기의 타임스탬프로 사용됩니다.

참고: Google 피트니스에서는 BMR을 사용하여 칼로리 소모량을 계산합니다. 앱에 직접 표시되지 않습니다.

REST

이름	com.google.calories.bmr
OAuth 권한 범위	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
필드 (형식—단위)	칼로리 (floatkcal/일) 키와 체중을 기준으로 사용자가 하루 종일 휴식을 취할 때 소모하는 칼로리 수입니다.

Android

이름	com.google.calories.bmr
데이터 유형 객체	TYPE_BASAL_METABOLIC_RATE
필드 (형식—단위)	FIELD_CALORIES (float—kcal/일) 연령, 체중, 키를 기준으로 사용자가 하루 종일 휴식을 취할 경우 소모되는 칼로리 수입니다.

칼로리 소모량

이 데이터 유형은 휴식 시 소모된 칼로리 (BMR)를 포함하여 사용자가 소모한 총 칼로리 (킬로칼로리)를 캡처합니다. 각 데이터 포인트는 시간 간격 동안 소모된 총 칼로리를 나타내므로 시작 시간과 종료 시간을 모두 설정해야 합니다.

참고: 칼로리 데이터를 작성할 때는 안정 시 소모된 칼로리 (사용자의 BMR)를 포함하세요.

REST

이름	com.google.calories.expended
OAuth 권한 범위	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
필드 (형식—단위)	칼로리 (float—kcal) 소모된 킬로칼로리 수입니다.

Android

이름	com.google.calories.expended
데이터 유형 객체	TYPE_CALORIES_EXPENDED
Android 권한	ACTIVITY_RECOGNITION
필드 (형식—단위)	FIELD_CALORIES (float—kcal) 소모된 킬로칼로리 수입니다.

사이클링 페달 회전수

사용자가 사이클링을 하는 경우 이 데이터 유형을 사용하여 분당 크랭크 회전수 (RPM)로 페달링 속도를 포착할 수 있습니다. 각 데이터 포인트는 페달링 속도의 순간 측정을 나타내므로 종료 시간만 설정해야 합니다. 이 값이 판독의 타임스탬프로 사용됩니다.

참고: 다양한 데이터 소스에서 순간 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
필드 (형식—단위)	revolutions (int—개수) 일정 기간 동안의 자전거 크랭크 회전수입니다.

Android

이름	com.google.cycling.pedaling.cumulative
데이터 유형 객체	TYPE_CYCLING_PEDALING_CUMULATIVE
필드 (형식—단위)	FIELD_REVOLUTIONS (int—count) 일정 기간 동안의 자전거 크랭크 회전수입니다.

심장 강화 점수

이 데이터 유형은 사용자가 모든 활동을 통해 획득한 심장 강화 점수를 포착합니다. 각 데이터 포인트는 시간 간격에 대해 계산된 심장 강화 점수를 나타냅니다.

사용자는 일일 심장 강화 점수 목표를 설정하고 진행 상황을 추적할 수 있습니다. 심장 강화 점수는 다음을 사용하여 계산할 수 있습니다.

• 심박수
• 신진대사해당치 (MET) 값
• 걷기 속도

획득하는 심장 강화 점수는 활동의 강도에 따라 다릅니다. 이 가이드를 사용하여 심장 강화 점수를 계산하고 기록하세요.

데이터	1HP (낮음~중간 강도 활동)	2 HP (고강도 활동)
심박수	최대 심박수의 50% 를 초과하는 활동 1분	최대 심박수의 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
필드 (형식—단위)	강도 (float~심장 강화 점수) 사용자가 하는 운동 또는 활동의 강도에 따라 획득한 심장 강화 점수입니다.

Android

이름	com.google.heart_minutes
데이터 유형 객체	TYPE_HEART_MINUTES
필드 (형식—단위)	FIELD_INTENSITY (float - 심장 포인트) 사용자가 하는 운동 또는 활동의 강도입니다. 가벼운 수준에서 중간 수준의 신체 활동 (예: 시속 4km 이상으로 걷기 또는 시속 16km 이상으로 자전거 타기) 1분은 심장 강화 점수 1점을 얻습니다. 강도 높은 활동을 1분간 하면 심장 강화 점수 2점을 얻을 수 있습니다.

운동 시간

이 데이터 유형은 사용자가 모든 활동을 통해 획득한 활동 시간(분)을 Google 피트니스에서 계산한 값을 캡처합니다. 각 데이터 포인트는 시간 간격의 추정된 활동 시간(분)을 나타냅니다. 시작 시간과 종료 시간을 모두 설정해야 합니다.

사용자는 요가, 댄스, 정원 가꾸기, 기타 집안일과 같은 활동을 통해 운동 시간을 획득할 수 있습니다. 산책을 하면 60초 이내에 30걸음 이상 걸을 때마다 Google Fit에서 활동 시간 1분을 부여합니다.

참고: 이러한 타임스탬프는 가장 가까운 분으로 올림 또는 내림해야 하므로 초 값은 항상 :00이어야 합니다.

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
필드 (형식—단위)	watts (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
필드 (형식—단위)	steps (int—count) 일정 기간 동안 걸은 걸음 수입니다. 유효한 범위: 초당 0~10단계

Android

이름	com.google.step_count.delta
데이터 유형 객체	TYPE_STEP_COUNT_DELTA
Android 권한	ACTIVITY_RECOGNITION
필드 (형식—단위)	TYPE_STEP_COUNT_DELTA (int—count) 일정 기간 동안 걸은 걸음 수입니다. 유효한 범위: 초당 0~10단계

운동

각 데이터 포인트는 사용자가 실행한 운동의 연속된 단일 세트를 나타냅니다. 데이터 포인트에는 운동 유형 (예: 저항 운동 또는 웨이트 트레이닝), 운동 반복 수, 운동 시간, 저항에 관한 필드가 포함됩니다.

REST

이름	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 repetitions (int—열거형) 운동의 반복 횟수입니다. resistance type (int—enum) 운동 중에 사용된 저항의 유형입니다. 허용되는 값 "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) 운동의 저항(또는 무게)(단위: kg)입니다. duration (int—밀리초) 지속 시간이 중요한 운동의 지속 시간입니다.

Android

이름

com.google.activity.exercise

필드 (형식—단위)

FIELD_EXERCISE (int—enum) 웨이트 리프팅 운동, 근력 운동, 심혈관 운동과 같은 다양한 운동을 나타내는 값입니다. 허용되는 값 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—enum) 운동 중에 사용된 저항의 유형입니다. 허용되는 값 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) 운동의 저항(또는 무게)(단위: kg)입니다. FIELD_DURATION (int—밀리초) 지속 시간이 중요한 운동의 지속 시간입니다.