Google Fit Samples Data Export Format
- Updated
The Google Fit Samples export contains a variety of data points ("samples") from the participant's Google Fit profile. This information may come from Fit-compatible apps or connected devices, and can include:
- Steps and Activities
- Vital Signs (e.g. heart rate and blood pressure)
- Nutrition (e.g. food intake)
- Other Measurements (e.g. blood glucose and weight)
The specific data will vary based on the capabilities of the participant's device, and what data they have elected to share with MyDataHelps.
Table of Contents
Data Fields
Field | Description |
---|---|
GoogleFitSampleKey |
A unique identifier for this sample. |
ParticipantIdentifier |
The MyDataHelps identifier of the participant associated with the Google Fit user. Can be used to cross reference with Participants. |
ParticipantID |
The stable, automatically generated, internal system identifier for this participant. Universally unique identifier (UUID). |
Type |
The type of sample, e.g. Steps or HeartRate. |
WindowStart |
An optional start time for the sample, in ISO 8601 format. Includes timezone offset information. May appear in records which take place over a time interval, like steps or activities. |
WindowEnd |
The timestamp when the sample was taken, in ISO 8601 format. Includes timezone offset information. |
Value |
The value recorded. For simple data like heart rate, weight, or steps, this will be a number. More complex data like nutrition will contain a JSON string with detailed activity information. |
Units |
Where applicable, contains the measurement units for the Value property (e.g. "lbs" for weight or "count" for steps). |
InsertedDate |
The date the entry was created in MyDataHelps, in ISO 8601 format. Is always in UTC. |
|
Google Fit provides additional context about the source of the data, such as the app that generated it and the model of the originating device. However, these fields use internal Google Fit identifiers and are probably not relevant to most researchers. Some data points may contain "OriginalDataSource" fields, which are only utilized for debugging the origin of data transformed or merged from multiple sources. |
Sample CSV Export
GoogleFitSampleKey,ParticipantIdentifier,Type,WindowStart,WindowEnd,Value,Units,DataSourceName,DataSourceAppPackageName,DataSourceStreamIdentifier,DataSourceStreamName,DataSourceDeviceManufacturer,DataSourceDeviceModel,DataSourceDeviceType,DataSourceDeviceUID,OriginalDataSourceName,OriginalDataSourceAppPackageName,OriginalDataSourceStreamIdentifier,OriginalDataSourceStreamName,OriginalDataSourceDeviceManufacturer,OriginalDataSourceDeviceModel,OriginalDataSourceDeviceType,OriginalDataSourceDeviceUID,InsertedDate
d988ab50-96bd-eb11-aa9f-dc90933df0b0,4533e4b4-3ba8-eb11-aa9e-b35d4295447e,Steps,2021-05-03T00:09:48-04:00,2021-05-03T00:11:16-04:00,44,count,,com.google.android.gms,derived:com.google.step_count.delta:com.google.android.gms:overlay_explicit_input_local,overlay_explicit_input_local,,,,,,,raw:com.google.step_count.cumulative:Google:Pixel 5:********:Step Counter,Step Counter,Google,Pixel 5,PHONE,********,2021-05-25T20:18:16Z
74075d1d-e8d2-ec11-aaad-85dd36217e6f,439847b8-413e-41c0-872d-5fd0e21dbaf2,Weight,2022-05-13T12:17:00-04:00,2022-05-13T12:17:00-04:00,160,lbs,,com.google.android.gms,derived:com.google.weight:com.google.android.gms:overlay_explicit_input_local,overlay_explicit_input_local,,,,,,com.google.android.apps.fitness,raw:com.google.weight:com.google.android.apps.fitness:user_input,user_input,,,,,2022-05-13T18:11:33Z
09b0f2cd-8191-eb11-aa9d-9b0caef93d5a,61d413d9-7e0d-eb11-aa90-b03d6db81eff,HeartRate,2021-03-30T13:59:46-04:00,2021-03-30T13:59:46-04:00,81,count/min,,com.google.android.gms,derived:com.google.heart_rate.bpm:com.google.android.gms:default_heart_rate_bpm,default_heart_rate_bpm,,,,,,com.repsi.heartrate,raw:com.google.heart_rate.bpm:com.repsi.heartrate:ContentValues - heart rate,ContentValues - heart rate,,,,,2021-03-30T18:00:31Z
615bfee5-38e8-ec11-aaad-85dd36217e6f,b78381f7-f260-4b2e-9df4-841357f751bd,SilverCloudSession,2022-06-09T10:59:00-04:00,2022-06-09T11:04:28-04:00,,,,com.silvercloudhealth.android.app,,,,,,,,,,,,,,,2022-06-09T21:12:42Z
Sample JSON Export
{ "GoogleFitSampleKey": "51F7C78F-4AE1-E911-8226-D99685DEB98E", "ParticipantIdentifier": "P7777", "Type": "Steps", "WindowStart": "2020-05-29T14:58:58-04:00", "WindowEnd": "2020-05-29T14:58:58-04:00", "Value": "7",
"Units": "count", "DataSourceAppPackageName": "com.google.android.gms", "DataSourceStreamName": "overlay_explicit_input_local", "OriginalDataSourceStreamName": "Step Counter sensor", "OriginalDataSourceDeviceManufacturer": "motorola",
"OriginalDataSourceDeviceModel": "Moto G (5) Plus",
"OriginalDataSourceDeviceType": "PHONE",
"InsertedDate": "2020-05-29T19:00:36Z" } { "GoogleFitSampleKey": "D45907DF-F68E-EA11-AA8A-BDD215061066", "ParticipantIdentifier": "A12345", "Type": "ActivitySegment", "WindowStart": "2020-05-05T13:28:07-04:00", "WindowEnd": "2020-05-05T13:35:17-04:00", "Value": "still", "DataSourceAppPackageName": "com.google.android.gms", "DataSourceStreamName": "overlay_explicit_input_local", "OriginalDataSourceAppPackageName": "com.google.android.gms", "OriginalDataSourceStreamName": "detailed", "OriginalDataSourceDeviceManufacturer": "motorola", "OriginalDataSourceDeviceModel": "Moto G (5) Plus", "OriginalDataSourceDeviceType": "PHONE", "InsertedDate": "2020-05-05T17:35:56Z" }
Was this article helpful?