Consolidate various health tracking platforms (Garmin, Polar, Apple Watch, etc.) into a single system.

September 6, 2024

In the ever-evolving landscape of digital health, the need for a unified platform that consolidates data from various health tracking devices has become paramount. This article provides an in-depth look at how to create a system that seamlessly integrates data from popular platforms such as Garmin, Polar, Apple Watch, Dexcom, Withings, Fitbit, and Spotify.

Core Functionality

Start: Comprehensive tracking of activities, nutrition, and mental health.

Connect: Synchronization of all devices and apps in one centralized platform.

Optimize: Personalized challenges and rewards to encourage self-care.

Detailed Integration Guide

Garmin Integration

Create a new application and obtain OAuth 2.0 credentials

Implement OAuth 2.0 flow for user authentication

Utilize the Garmin Health API to fetch:

Activity data (steps, distance, calories)

Heart rate data (resting, active)

Sleep data

Stress levels

Example code snippet for fetching Garmin activities:

typescript 
const fetchGarminActivities = async (event: any) => {
    const oauthToken = event.oauthToken;
    const oauthTokenSecret = event.oauthTokenSecret;

    const currentDate = new Date();
    const summaryStartTimeInSeconds = Math.floor(Date.UTC(currentDate.getUTCFullYear(), currentDate.getUTCMonth(), currentDate.getUTCDate(), 0, 0, 0, 0) / 1000);
    const summaryEndTimeInSeconds = summaryStartTimeInSeconds + 86400;

    try {
        const response = await axios({
            method: "GET",
            url: "https://apis.garmin.com/wellness-api/rest/backfill/activityDetails",
            headers: generateOauthSignatureHeaders({
                method: "GET",
                url: "https://apis.garmin.com/wellness-api/rest/backfill/activityDetails",
                oauthToken,
                oauthTokenSecret,
                summaryStartTimeInSeconds,
                summaryEndTimeInSeconds,
            }),
            params: {
                summaryStartTimeInSeconds,
                summaryEndTimeInSeconds,
            },
        });
        // Process and store the activity data
    } catch (error) {
        console.error(error?.response?.data ?? error);
    }
};

‌

‌
‌
‌
‌

‌

‌
‌
‌

‌

Dexcom Integration

Create a new application and obtain OAuth 2.0 credentials

Implement OAuth 2.0 flow for user authorization

Use the Dexcom API to fetch glucose data

Store and process glucose metrics in your backend

Implementation steps (as per the provided image):

A visual depiction of what is being written about

‌

‌
‌
‌
‌

‌

‌
‌
‌

‌

Polar Integration

Create a new application and obtain OAuth 2.0 credentials

Implement OAuth 2.0 flow for user authentication

Use the Polar AccessLink API to retrieve:

Activity data

Heart rate data

Training sessions

Example code snippet for fetching Polar activities:

typescript 
const fetchPolarActivityList = async (event: any) => {
    const accessToken = event.accessToken;
    const userId = event.userId;

    try {
        const response = await axios({
            method: "GET",
            url: `https://www.polaraccesslink.com/v3/users/${userId}/activity-transactions`,
            headers: {
                Authorization: `Bearer ${accessToken}`,
            },
        });
        // Process and store the activity data
    } catch (error) {
        console.error(error?.response?.data ?? error);
    }
};

‌

‌
‌
‌
‌

‌

‌
‌
‌

‌

Withings Integration

Create a new application and obtain OAuth 2.0 credentials

Implement OAuth 2.0 flow for user authorization

Use the Withings API to fetch:

Weight data

Sleep data

Activity data

Other health metrics (e.g., blood pressure)

‌

‌
‌
‌
‌

‌

‌
‌
‌

‌

Fitbit Integration

Create a new application and obtain OAuth 2.0 credentials

Implement OAuth 2.0 flow for user authentication

Use the Fitbit Web API to access:

Activity data

Heart rate data

Sleep data

Example code snippet for fetching Fitbit activities:

typescript 
const fetchFitbitActivities = async (event: any) => {
    const accessToken = event.accessToken;
    const userId = event.userId;

    try {
        const response = await axios({
            method: "GET",
            url: `https://api.fitbit.com/1/user/${userId}/activities/list.json`,
            headers: {
                Authorization: `Bearer ${accessToken}`,
            },
            params: {
                sort: 'desc',
                offset: 0,
                limit: 100,
            },
        });
        // Process and store the activity data
    } catch (error) {
        console.error(error?.response?.data ?? error);
    }
};

‌

‌
‌
‌
‌

‌

‌
‌
‌

‌

Apple HealthKit Integration

Enable HealthKit capabilities in your Xcode project

Request user permission to access health data

Use the HealthKit framework to read and write health and fitness data

Example code snippet for initializing HealthKit:

typescript 
initHealthKit = () => {
    let options = {
        permissions: {
            read: [
                'Height', 'Weight', PERMS.StepCount, PERMS.BodyFatPercentage,
                PERMS.Step, PERMS.DistanceWalkingRunning, PERMS.HeartRate,
                PERMS.BodyTemperature, PERMS.BloodPressureDiastolic,
            ],
            write: ['Height', 'Weight'],
        },
    }

    AppleHealthKit.isAvailable((error, available) => {
        if (available) {
            AppleHealthKit.initHealthKit(options, (err, results) => {
                if (err) {
                    console.error('Error initializing HealthKit', err);
                } else {
                    console.log('HealthKit initialized successfully');
                }
            });
        } else {
            console.error('HealthKit is not available on this device');
        }
    });
}

‌

‌
‌
‌
‌

‌

‌
‌
‌

‌

Spotify Integration (for workout music)

Create a new application and obtain OAuth 2.0 credentials

Implement OAuth 2.0 flow for user authentication

Use the Spotify Web API to:

Create playlists

Add tracks

Control playback

‌

‌
‌
‌
‌

‌

‌
‌
‌

‌

Data Consolidation and Storage

To create a unified experience, implement a robust backend system:

Normalize data from different sources into a common format

Use a database like DynamoDB to store consolidated data

Implement efficient data synchronization mechanisms

Example of storing activity data in DynamoDB:

typescript 
const createActivityEvent = async (
    eventInfo: {
        userId: string;
        title: string;
        latitude?: number;
        longitude?: number;
        fitbitLogId?: string;
        garminSummaryId?: string;
        polarExerciseId?: string;
        appleActivityId?: string;
        startDate?: string | null;
        endDate?: string | null;
        activityType: string;
    },
    healthMetrics: {
        avgHr: number | null;
        avgPace: number | null;
        calories: number | null;
        distanceInMeters: number | null;
        steps: number | null;
        vo2Max: number | null;
    },
    user: User
) => {
    const date = new Date();
    const eventPayload = {
        TableName: process.env.EVENTS_TABLE_NAME as string,
        Item: {
            id: uuidv4(),
            userId: eventInfo.userId,
            title: eventInfo.title,
            startDate: eventInfo.startDate,
            endDate: eventInfo.endDate,
            activityType: eventInfo.activityType,
            healthMetrics: healthMetrics,
            createdAt: date.toISOString(),
            updatedAt: date.toISOString(),
        },
    };

    await dbClient.put(eventPayload).promise();
};

Challenges and Considerations

Data Privacy: Ensure compliance with GDPR, HIPAA, and other relevant regulations

Data Synchronization: Implement efficient syncing mechanisms to keep data up-to-date across platforms

Battery Life: Optimize data fetching to minimize impact on device battery life

User Experience: Create an intuitive interface that presents data from multiple sources coherently

Error Handling: Implement robust error handling for API failures and data inconsistencies

Scalability: Design the system to handle a growing number of users and increasing data volumes

Conclusion

By meticulously integrating various health tracking platforms into a single system, you can provide users with a comprehensive and seamless health monitoring experience. This unified approach not only simplifies data management for users but also enables more accurate insights and personalized recommendations. As you develop your integrated health tracking app, prioritize data accuracy, user privacy, and a smooth user experience across all connected devices and platforms.

Discussion (0)

Recommended articles

Jenkins Slack Integration

Exploring Colyseus: Building Scalable Game Servers and Enhancing Team Performance