The Google Fit APIs, including the Google Fit REST API, will no longer be available after June 30, 2025. As of May 1, 2024, developers cannot sign up to use these APIs.

For instructions on which API or platform to migrate to, visit the Health Connect migration guide. For a comparison of Health Connect with the Google Fit APIs and the Fitbit Web APIs, visit the Health Connect comparison guide.

Learn more about Health Connect and how to integrate with the API.

Location data types

Data types for location data.

Cycling wheel revolution RPM

If a user goes cycling, this data type can be used to capture their wheel revolutions per minute (RPM). Each data point represents an instantaneous measure of the wheel revolutions, so only the end time should be set. This will be used as the timestamp for the reading.

REST

Name	`com.google.cycling.wheel_revolution.rpm`
OAuth permission scopes	https://www.googleapis.com/auth/fitness.location.read https://www.googleapis.com/auth/fitness.location.write
Fields (format—units)	rpm (`float`—rpm) Number of bicycle wheel revolutions per minute.

Android

Name	`com.google.cycling.wheel_revolution.rpm`
Data type object	`TYPE_CYCLING_WHEEL_RPM`
Fields (format—units)	FIELD_RPM (`float`—rpm) Number of bicycle wheel revolutions per minute.

Cycling wheel revolution cumulative

If a user goes cycling, this data type can be used to capture the number of wheel revolutions over a time period. Each data point represents the number of revolutions since the count at the start time.

REST

Name	`com.google.cycling.wheel_revolution.cumulative`
OAuth permission scopes	https://www.googleapis.com/auth/fitness.location.read https://www.googleapis.com/auth/fitness.location.write
Fields (format—units)	revolutions (`int`—count) Number of bicycle wheel revolutions.

Android

Name	`com.google.cycling.wheel_revolution.cumulative`
Data type object	`TYPE_CYCLING_PEDALING_CUMULATIVE`
Fields (format—units)	FIELD_REVOLUTIONS (`int`—count) Number of bicycle wheel revolutions.

Distance delta

This data type captures distance travelled by the user since the last reading, in meters. The total distance over an interval can be calculated by adding together all the values during the interval. The start time of each data point should represent the start of the interval in which the distance was covered. The start time must be equal to or greater than the end time of the previous data point.

REST

Name	`com.google.distance.delta`
OAuth permission scopes	https://www.googleapis.com/auth/fitness.location.read https://www.googleapis.com/auth/fitness.location.write
Fields (format—units)	distance (`float`—meters) Distance travelled in meters. Valid range: 0—100 meters per second

Android

Name	`com.google.distance.delta`
Data type object	`TYPE_DISTANCE_DELTA`
Android permissions	`ACCESS_FINE_LOCATION` and `ACTIVITY_RECOGNITION`
Fields (format—units)	FIELD_DISTANCE (`float`—meters) Distance travelled in meters. Valid range: 0—100 meters per second

Location sample

This data type captures the user's location. Because each data point represents the location 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.location.sample

OAuth permission scopes

https://www.googleapis.com/auth/fitness.location.read

https://www.googleapis.com/auth/fitness.location.write

Fields (format—units)

latitude (float—degrees)

The latitude of a location in degrees.

Valid range: -90 to 90 degrees

longitude (float—degrees)

The longitude of a location in degrees.

Valid range: -180 to 180 degrees

accuracy (float—meters)

The estimated 'radius of accuracy' the location would be within, in meters. For example, if you drew a circle around this location with a radius equal to the accuracy, there should be a 68% chance that the user's true location is within the circle. This estimate is for horizontal accuracy only. It doesn't indicate the accuracy of bearing, velocity or altitude (if those are included for this Location). If this location doesn't have a horizontal accuracy, then 0.0 is returned.

Valid range: 0—10,000 meters

altitude (float—meters)

The height of the location from sea level, in meters.

Valid range: -100,000—100,000 meters

Android

Name com.google.location.sample

Data type object TYPE_LOCATION_SAMPLE

Android permission ACCESS_FINE_LOCATION

Fields (format—units)

FIELD_LATITUDE (float—degrees)

The latitude of a location in degrees.

Valid range: -90 to 90 degrees

FIELD_LONGITUDE (float—degrees)

The longitude of a location in degrees.

Valid range: -180 to 180 degrees

FIELD_ACCURACY (float—meters)

Valid range: 0—10,000 meters

FIELD_ALTITUDE (float—meters)

The height of the location from sea level, in meters.

Valid range: -100,000—100,000 meters

Speed

This data type captures the user's speed in meters per second. The value represents the scalar magnitude of the speed, so negative values should not occur. Because each data point represents the speed 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.speed`
OAuth permission scopes	https://www.googleapis.com/auth/fitness.location.read https://www.googleapis.com/auth/fitness.location.write
Fields (format—units)	speed (`float`—meters per second) Travelling speed. Valid range: 0—11,000 meters per second

Android

Name	`com.google.speed`
Data type object	`TYPE_SPEED`
Android permission	`ACCESS_FINE_LOCATION`
Fields (format—units)	speed (`float`—meters per second) Travelling speed. Valid range: 0—11,000 meters per second