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
| Name | com.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
| Name | com.google.body.fat.percentage |
| Data type object | TYPE_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
| Name | com.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
| Name | com.google.heart_rate.bpm |
| Data type object | TYPE_HEART_RATE_BPM |
| Android permission | BODY_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
| Name | com.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
| Name | com.google.height |
| Data type object | TYPE_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
| Name | com.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
| Name | com.google.weight |
| Data type object | TYPE_WEIGHT |
| Fields (format—units) | FIELD_WEIGHT (float—kgs)
Body weight in kilograms.
Valid range: 0—1000 kilograms |