We're making some changes to the Google Fit APIs. Learn about how these changes might affect your app. Read our new policy.

Body data types

Data types for common body measurements.

Body fat percentage

This data type captures the body fat percentage of a user. Each data point represents a person's total body fat as a percentage of their total body mass.

REST

Namecom.google.body.fat.percentage
OAuth permission scopes
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
Fields (format—units) percentage (float—percent)
Percentage of total body mass that is body fat.
Valid range: 0—100%

Android

Namecom.google.body.fat.percentage
Data type objectTYPE_BODY_FAT_PERCENTAGE
Fields (format—units) FIELD_PERCENTAGE (float—percent)
Percentage of total body mass that is body fat.
Valid range: 0—100%

Heart rate

This data type captures the user's heart rate in beats per minute. Because each data point represents an instantaneous measure of heart rate, only the end time should be set. This will be used as the timestamp for the reading.

REST

Namecom.google.heart_rate.bpm
OAuth permission scopes
https://www.googleapis.com/auth/fitness.heart_rate.read
https://www.googleapis.com/auth/fitness.heart_rate.write
Fields (format—units) bpm (float—bpm)
Heart rate in beats per minute.
Valid range: 0—1000

Android

Namecom.google.heart_rate.bpm
Data type objectTYPE_HEART_RATE_BPM
Android permissionBODY_SENSORS to record
Fields (format—units) bpm (float—bpm)
Heart rate in beats per minute.
Valid range: 0—1000 bpm

Height

This data type captures that user's height in meters. Because each data point represents the height of the user at the time of the reading, only the end time should be set. This will be used as the timestamp for the reading.

REST

Namecom.google.height
OAuth permission scopes
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
Fields (format—units) height (float—meters)
Height in meters.
Valid range: 0—3 meters

Android

Namecom.google.height
Data type objectTYPE_HEIGHT
Fields (format—units) FIELD_HEIGHT (float—meters)
Height in meters.
Valid range: 0—3 meters

Weight

This data type captures that user's weight in kilograms. Because each data point represents the weight of the user at the time of the reading, only the end time should be set. This will be used as the timestamp for the reading.

REST

Namecom.google.weight
OAuth permission scopes
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
Fields (format—units) weight (float—kgs)
Body weight in kilograms.
Valid range: 0—1000 kilograms

Android

Namecom.google.weight
Data type objectTYPE_WEIGHT
Fields (format—units) FIELD_WEIGHT (float—kgs)
Body weight in kilograms.
Valid range: 0—1000 kilograms