December updates
TL;DR
- Localization Field in Metadata: Enhanced clarity for UTC vs. user-specific UTC+0.
- Garmin Planned Workouts with REPS: Strength-based workouts just got smarter!
- Closed Beta Blood Report API: Turn PDFs and images into structured biomarker data.
Metadata Localization Field 🕒
What?
We’ve introduced a new localization field in the metadata for all data payloads. This indicates whether the provider truly operates in UTC or if they're merely reporting all timestamps as UTC (without any timezone variation). Developers often rely on the ISO8601 standard but might encounter quirks if providers force “UTC” data instead of a user’s actual timezone. Now, our metadata clarifies exactly how the time was reported—ensuring you know if it’s real UTC+0 or “UTC” because the provider doesn’t offer local time data.
Why?
Not all wearables and platforms are created equal when it comes to timestamp consistency. Some only provide times in UTC (or claim it’s UTC but really just default to “Z” format), while others genuinely account for different time zones. This can lead to confusion when developers try to align health metrics, especially for users traveling or living in different time zones. By adding this field, we reduce the guesswork and prevent potential parsing errors for apps that don’t automatically handle the “Z” notation.
How?
Our system now inspects and flags incoming data. If the source truly includes local time offsets, we mark it as such; if not, you’ll see a clear indicator in the metadata, helping you confidently parse or transform data to the user’s local time. It’s a small change with big implications for your data integrity.
Garmin Planned Workouts: Now with REPS! 💪
What?
We’ve expanded support for Garmin Planned Workouts by adding REPS. If you’re using Terra to create planned workouts on Garmin devices, you can now specify the number of repetitions for strength-based exercises—perfect for gym routines, circuit training, or HIIT sessions.
Why?
Workouts aren’t just about duration and distance. Strength sessions revolve around how many reps you can push out. By building this into the planned workout feature, Terra helps users follow detailed exercise plans directly on their Garmin watch. No more scribbling sets on paper—now the watch guides you through each rep!
How?
When you create a planned workout via our API, just include the reps parameter for each exercise. Garmin devices will display these reps, making it easier than ever for users to stay on track. It’s an evolution that transforms Terra from an endurance-oriented solution to a well-rounded fitness partner for all workout styles.
Blood Report API (Closed Beta) 🩸
What?
Say hello to our Blood Report API, now in closed beta! This new product takes images or PDFs of blood (and other biomarker) reports and converts them into structured JSON—covering everything from thyroid markers to iron levels. No more manual data entry or guesswork; just clean, consistent data ready for integration.
Why?
Blood tests offer some of the richest insights into personal health. Yet, they often arrive in formats that are tough to parse, store, or analyze. We’re solving that problem. By integrating blood biomarker data into your app, you can empower users with tailored health insights—spotting early warning signs, personalizing nutrition recommendations, or simply helping users understand how their lifestyle impacts their health at the biomarker level.
How?
Through Terra’s Biomarkers API, you can upload PDF or image files of lab reports. Our pipeline then extracts and standardizes key markers—like liver enzymes, thyroid hormones, or glucose levels—into JSON. This ensures a smooth developer experience and helps you build advanced features like alert systems, personalized recommendations, or deeper health trend analysis.
Interested in testing this feature? Reach out to our team to request beta access!
Wrapping Up
These December 2024 updates highlight our ongoing mission to simplify health and fitness data management. Whether it’s adding time zone clarity, making Garmin workouts more reps-friendly, or transforming raw blood reports into actionable data, we’re committed to helping you build better, more user-centric health solutions.
Stay tuned for more in the new year! 🎉
