활동 데이터 유형

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

활동

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

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

각 데이터 포인트에는 시작 시간과 종료 시간이 필요합니다. 데이터 포인트는 연속적으로 또는 서로 직접 연결되어 있지 않아도 되며 사이에 간격이 있을 수 있습니다.

참고: 동일한 스트림의 데이터 포인트의 시간 범위는 겹치면 안 됩니다. 그럴 경우 겹치는 기간의 데이터가 삭제되어 예상 값과 표시된 값 사이에 불일치가 발생할 수 있습니다.

REST

이름	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

이름	com.google.activity.segment
데이터 유형 객체	TYPE_ACTIVITY_SEGMENT
Android 권한	ACTIVITY_RECOGNITION
필드 (형식—단위)	FIELD_ACTIVITY (int—열거형) 사용자가 진행 중인 활동의 유형. 활동 유형 목록은 여기를 참고하세요.

기초대사율 (BMR)

이 데이터 유형은 사용자의 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
필드 (형식—단위)	칼로리 (float—일일 kcal) 키와 체중을 기준으로 사용자가 하루 종일 쉬고 있을 때 소모할 킬로칼로리입니다.

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
필드 (형식—단위)	회전 (int—횟수) 특정 기간의 자전거 크랭크 회전수입니다.

Android

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

심장 강화 점수

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

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

• 심박수
• MET (대사당량) 값
• 걸음 속도

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

데이터	1HP (낮음-중간 강도의 활동)	2HP (고강도 활동)
심박수	최대 심박수가 50% 를 초과할 때 활동 1분	최대 심박수가 70% 를 넘는 상태에서 1분간 활동
MET 값	3~6MET. 예를 들어 조정이나 암벽 등반을 하면	>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
필드 (형식—단위)	inintity (float: 심장 강화 점수) 사용자의 운동 또는 활동의 강도에 따라 획득한 심장 강화 점수입니다.

Android

이름	com.google.heart_minutes
데이터 유형 객체	TYPE_HEART_MINUTES
필드 (형식—단위)	FIELD_INTENSITY (float—하트 포인트) 사용자가 수행하는 운동 또는 활동의 강도입니다. 1분 동안 가벼운 신체 활동에서 중간 강도의 신체 활동 (예: 2.5mph보다 빠르게 걷거나 10mph보다 빠르게 사이클링)을 하면 심장 강화 점수 1점을 얻습니다. 1분 더 격렬한 활동을 하면 심장 강화 점수 2점을 얻습니다.

운동 시간

이 데이터 유형은 Google 피트니스가 사용자의 모든 활동에서 얻은 운동 시간(분)을 캡처합니다. 각 데이터 포인트는 시간 간격 동안 파생된 운동 시간(분)을 나타냅니다. 시작 시간과 종료 시간을 모두 설정해야 합니다.

사용자는 요가, 댄스, 정원 가꾸기, 기타 집안일을 통해 운동 시간을 얻을 수 있습니다. 사용자가 산책을 하는 경우 Google 피트니스에서는 60초 이내에 30걸음 이상 걸을 때마다 운동 시간 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
필드 (형식—단위)	와트 (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—걸음 수/분) 분당 걸음 수로 측정된 Cadence입니다.

Android

이름	com.google.step_count.cadence
데이터 유형 객체	TYPE_STEP_COUNT_CADENCE
필드 (형식—단위)	FIELD_RPM (float—걸음 수/분) 분당 걸음 수로 측정된 Cadence입니다.

걸음 수 델타

이 데이터 유형은 마지막 판독 이후 걸은 걸음 수를 캡처합니다. 각 단계는 한 번만 보고되므로 데이터 포인트에 시간이 겹치면 안 됩니다. 각 데이터 포인트의 시작 시간은 걸음을 걸은 간격의 시작을 나타내야 합니다.

시작 시간은 이전 데이터 포인트의 종료 시간과 같거나 그보다 커야 합니다. 일정 기간 동안의 모든 값을 함께 더하면 해당 기간 동안의 총 단계 수가 계산됩니다.

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—개수) 특정 기간 동안 걸은 걸음 수입니다. 유효 범위: 0~10걸음/초

Android

이름	com.google.step_count.delta
데이터 유형 객체	TYPE_STEP_COUNT_DELTA
Android 권한	ACTIVITY_RECOGNITION
필드 (형식—단위)	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
필드 (형식—단위)	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—열거형) 운동의 반복 횟수입니다. 저항 유형 (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—밀리초) 시간이 중요한 운동의 지속 시간입니다.