Articles in this section

Google Fit Samples Data Export Format

  • Updated
Follow

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.

DataSource

OriginalDataSource

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"
  }

Related articles