> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gymlive.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Fit Integration

> Connect Google Fit with GymLive to sync your fitness data from Android devices

# Google Fit Integration

Google Fit is Google's health and fitness platform that aggregates data from your Android phone, Wear OS devices, and compatible fitness apps. Connect Google Fit to GymLive to share your comprehensive activity data with your coach.

<Info>
  Google Fit integration requires signing in with your Google account to authorize data sharing with GymLive.
</Info>

## What Data Can Be Synced?

Google Fit aggregates data from multiple sources:

* **Activity Tracking**: Steps, distance, calories, move minutes
* **Heart Points**: Intensity-based activity scoring
* **Workouts**: Running, cycling, strength training, 100+ activities
* **Heart Rate**: From Wear OS watches and compatible devices
* **Sleep**: Basic sleep tracking (with compatible apps)
* **Weight & Body Metrics**: Manual entries or from smart scales
* **Nutrition**: Water intake and meal logging
* **Meditation**: Mindfulness session tracking
* **Location Data**: GPS routes for outdoor activities

## Setup Instructions

<Steps>
  <Step title="Prepare Google Fit">
    Ensure Google Fit is properly configured:

    1. Download **Google Fit** from Play Store if not installed
    2. Open Google Fit and sign in with your Google account
    3. Complete the initial setup and profile information
    4. Grant necessary permissions for activity tracking

    <Note>
      Google Fit automatically tracks basic activities using your phone's sensors.
    </Note>
  </Step>

  <Step title="Connect Google Fit to GymLive">
    In the GymLive app:

    1. Go to **Settings** > **Integrations**
    2. Select **Google Fit**
    3. Tap **Sign in with Google**
    4. You'll be redirected to Google's sign-in page
  </Step>

  <Step title="Grant Permissions">
    On Google's authorization page:

    1. Choose your Google account
    2. Review the permissions GymLive requests
    3. Click **Allow** to grant access
    4. You'll return to GymLive automatically

    <Warning>
      Use the same Google account that you use for Google Fit.
    </Warning>
  </Step>

  <Step title="Enable Health Connect (Recommended)">
    For better Android integration:

    1. If prompted, install **Health Connect**
    2. In Google Fit: **Profile** > **Settings**
    3. Tap **Manage Health Connect**
    4. Enable Google Fit as a data source
    5. This improves data flow to GymLive
  </Step>
</Steps>

## Understanding Google Fit Metrics

### Move Minutes

Active time that gets you moving:

* Any activity beyond normal daily movement
* Walking, cleaning, playing with kids
* Goal: 150 minutes per week (WHO recommendation)

### Heart Points

Intensity-based activity score:

* 1 point per minute of moderate activity (brisk walking)
* 2 points per minute of vigorous activity (running)
* Goal: 150 points per week for heart health

### Activity Goals

Google Fit uses smart goals:

* Adjusts based on your activity history
* Increases gradually as you improve
* Celebrates streaks and achievements

## Data Sources

Google Fit aggregates data from:

<CardGroup cols={2}>
  <Card title="Phone Sensors" icon="mobile">
    Automatic step and activity detection using accelerometer
  </Card>

  <Card title="Wear OS" icon="watch">
    Heart rate, advanced metrics from smartwatches
  </Card>

  <Card title="Connected Apps" icon="link">
    Strava, MyFitnessPal, Sleep as Android, etc.
  </Card>

  <Card title="Manual Entry" icon="keyboard">
    Add workouts, weight, and other data manually
  </Card>
</CardGroup>

## Syncing Process

### Automatic Sync

Google Fit to GymLive sync:

1. **Real-time**: Phone sensor data updates continuously
2. **App data**: When connected apps sync to Google Fit
3. **Cloud sync**: Google Fit uploads when online
4. **GymLive pull**: Checks for new data every 15-30 minutes

### Manual Sync

To force sync:

1. Open **Google Fit** app
2. Pull down from the journal tab
3. See sync animation complete
4. Open **GymLive** and pull to refresh
5. Data should appear within 5 minutes

<Note>
  Google Fit may have 30-60 minute delays for data to become available via API.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="No data in GymLive">
    1. **Verify Google Fit has data**:
       * Open Google Fit app
       * Check today's metrics are showing
       * Pull down to sync
    2. **Check account match**:
       * Settings > Account in Google Fit
       * Same account connected to GymLive?
    3. **Force refresh**:
       * Wait 30-60 minutes (API delay)
       * Pull to refresh in GymLive
  </Accordion>

  <Accordion title="Missing workouts">
    Google Fit workout detection:

    * Requires 10+ minutes of continuous activity
    * Must meet intensity thresholds
    * May miss strength training

    Solution: Manually log workouts in Google Fit
  </Accordion>

  <Accordion title="Wear OS data not syncing">
    1. Check watch is paired properly
    2. Open Google Fit on watch
    3. Ensure sync icon shows
    4. On phone: Google Fit > Settings > Manage connected devices
    5. Verify watch is listed and connected
  </Accordion>

  <Accordion title="Permission issues">
    Re-authorize connection:

    1. Disconnect Google Fit in GymLive
    2. Go to myaccount.google.com/permissions
    3. Remove GymLive access
    4. Reconnect in GymLive app
    5. Grant all requested permissions
  </Accordion>
</AccordionGroup>

## Wear OS Integration

For Wear OS smartwatch users:

### Supported Devices

* Samsung Galaxy Watch 4/5/6
* Pixel Watch series
* Fossil Gen 6
* TicWatch Pro series
* Other Wear OS 3+ devices

### Enhanced Metrics

With Wear OS devices:

* Continuous heart rate
* Automatic workout detection
* Sleep tracking (device dependent)
* Stress and recovery metrics
* GPS tracking for outdoor activities

### Setup Tips

1. Pair watch with phone first
2. Install Google Fit on watch
3. Sign in with same Google account
4. Enable all permissions
5. Wear watch during activities

## Connected Apps

Popular apps that sync through Google Fit:

<Tabs>
  <Tab title="Fitness Apps">
    * **Strava**: Running and cycling
    * **Nike Run Club**: Running workouts
    * **Adidas Running**: GPS tracking
    * **7 Minute Workout**: Quick exercises
    * **Zombies, Run!**: Gamified running
  </Tab>

  <Tab title="Health Apps">
    * **MyFitnessPal**: Nutrition tracking
    * **Sleep as Android**: Advanced sleep analysis
    * **Headspace**: Meditation sessions
    * **Water Reminder**: Hydration tracking
    * **Lifesum**: Diet and nutrition
  </Tab>

  <Tab title="Device Apps">
    * **Mi Fit**: Xiaomi devices
    * **Zepp**: Amazfit devices
    * **Withings Health Mate**: Smart scales
    * **Polar Flow**: Polar devices
    * **Huawei Health**: Huawei wearables
  </Tab>
</Tabs>

## Best Practices

<CardGroup cols={2}>
  <Card title="Phone Placement" icon="mobile-screen">
    Carry phone in pocket for accurate step counting
  </Card>

  <Card title="Regular Opening" icon="clock-rotate-left">
    Open Google Fit daily to ensure cloud sync
  </Card>

  <Card title="Manual Logging" icon="pen">
    Add activities Google Fit might miss (strength, yoga)
  </Card>

  <Card title="Connected Apps" icon="puzzle-piece">
    Link favorite fitness apps for comprehensive data
  </Card>
</CardGroup>

## Privacy & Data Control

* Google OAuth 2.0 secure authentication
* GymLive never sees your Google password
* You control which data scopes are shared
* Revoke access at myaccount.google.com
* Data encrypted in transit
* Complies with Google API policies

### Managing Permissions

1. Visit: myaccount.google.com/permissions
2. Find GymLive in the list
3. Click to view granted permissions
4. Remove access if needed

## Optimizing Battery Life

Google Fit background tracking:

1. **Adaptive Battery**:
   * Settings > Battery > Adaptive Battery
   * Ensures Google Fit can track in background

2. **Location Settings**:
   * Use "Battery saving" mode for basic tracking
   * "High accuracy" for GPS workouts only

3. **Sync Frequency**:
   * Google Fit syncs when connected to WiFi
   * Reduces battery drain from constant uploads

## Limitations

<Warning>
  **Known Google Fit Limitations**

  * 30-60 minute API delays common
  * Limited sleep tracking without third-party apps
  * Strength training detection needs improvement
  * Some Wear OS features device-specific
  * Historical data limited to certain timeframes
</Warning>

## Related Resources

* [Google Fit Help Center](https://support.google.com/fit)
* [Wear OS Support](https://support.google.com/wearos)
* [GymLive Troubleshooting Guide](/integrations/troubleshooting)