如何用Garth高效获取Garmin健康数据睡眠、心率与活动数据抓取教程【免费下载链接】garth[DEPRECATED] Garmin SSO auth Connect Python client项目地址: https://gitcode.com/gh_mirrors/ga/garthGarth是一款功能强大的Python客户端专为从Garmin Connect平台获取健康数据而设计。无论是睡眠质量分析、心率监测还是活动记录Garth都能帮助你轻松获取并处理这些宝贵的健康数据。本教程将详细介绍如何使用Garth高效获取各类健康数据让你的健康管理更加科学、便捷。快速开始Garth安装与配置指南要开始使用Garth首先需要进行简单的安装和配置。推荐使用Python包管理器pip进行安装只需在终端中执行以下命令python -m pip install garth如果你需要获取最新的开发版本可以通过GitHub仓库进行安装git clone https://gitcode.com/gh_mirrors/ga/garth cd garth python setup.py install安装完成后需要进行简单的配置。Garth提供了灵活的配置选项可以通过garth.configure()函数进行设置。例如如果你需要连接到中国区服务器可以这样配置import garth garth.configure(domaingarmin.cn)更多配置选项可以参考官方文档docs/configuration.md账户认证安全登录Garmin ConnectGarth支持多种登录方式包括邮箱密码登录和MFA多因素认证。最基本的登录方式如下import garth garth.login(your_emailexample.com, your_password)登录成功后Garth会自动保存会话信息。你也可以将会话保存到文件以便后续使用garth.save(~/.garth)下次使用时只需加载保存的会话即可garth.resume(~/.garth)对于启用了MFA的账户Garth提供了便捷的支持garth.login(email, password, prompt_mfalambda: input(Enter MFA code: ))睡眠数据获取深入了解你的睡眠质量Garth提供了多种获取睡眠数据的方式从详细的睡眠阶段分析到每日睡眠摘要满足不同的分析需求。获取详细睡眠数据使用SleepData.get()方法可以获取特定日期的详细睡眠数据包括睡眠阶段、睡眠评分等信息from datetime import date sleep_data garth.SleepData.get(2023-07-20)返回的sleep_data对象包含丰富的睡眠信息例如睡眠开始和结束时间深睡、浅睡、REM睡眠和清醒时间睡眠评分和反馈睡眠期间的活动和压力水平获取睡眠摘要数据DailySleepData类提供了更全面的睡眠摘要包括睡眠需求和恢复情况daily_sleep garth.DailySleepData.get(2025-07-07) print(f睡眠需求: {daily_sleep.sleep_need_minutes} 分钟) print(f实际睡眠: {daily_sleep.daily_sleep_dto.sleep_time_seconds / 60} 分钟)批量获取睡眠数据要分析一段时间的睡眠趋势可以使用list()方法批量获取睡眠数据# 获取过去7天的睡眠数据 sleep_history garth.SleepData.list(2023-07-20, 7) for sleep in sleep_history: print(f{sleep.daily_sleep_dto.calendar_date}: {sleep.sleep_score}分)心率数据获取实时掌握心脏健康状况Garth提供了全面的心率数据获取功能包括静息心率、心率变异性HRV以及详细的心率时间序列数据。获取每日心率摘要使用DailyHeartRate.get()方法可以获取特定日期的心率摘要数据hr_data garth.DailyHeartRate.get(2024-01-15) print(f静息心率: {hr_data.resting_heart_rate} BPM) print(f最大心率: {hr_data.max_heart_rate} BPM) print(f平均心率: {hr_data.average_heart_rate} BPM)获取心率变异性HRV数据HRV是评估心血管健康和压力水平的重要指标。Garth提供了便捷的HRV数据获取方法hrv_data garth.HRVData.get(2023-07-20) print(fHRV平均值: {hrv_data.hrv_summary.average_hrv} ms) print(f睡眠期间HRV: {hrv_data.hrv_summary.sleep_hrv} ms)获取详细心率时间序列数据对于需要详细分析心率变化的场景可以获取全天的心率时间序列数据hr_readings garth.DailyHeartRate.get(2024-01-15).heart_rate_readings for reading in hr_readings[:10]: # 打印前10条记录 print(f{reading.timestamp}: {reading.value} BPM)活动数据获取全面记录你的运动表现Garth能够获取各种类型的活动数据包括跑步、骑行、游泳等并提供详细的运动指标和摘要信息。获取活动列表使用Activity.list()方法可以获取活动列表activities garth.Activity.list(limit10) for activity in activities: print(f{activity.activity_name} ({activity.activity_type.type_key}): {activity.summary.distance}米)获取活动详情要获取特定活动的详细信息可以使用Activity.get()方法activity garth.Activity.get(21522899847) print(f活动名称: {activity.activity_name}) print(f活动类型: {activity.activity_type.type_key}) print(f距离: {activity.summary.distance} 米) print(f持续时间: {activity.summary.duration} 秒) print(f平均心率: {activity.summary.average_hr} BPM) print(f消耗卡路里: {activity.summary.calories})更新活动信息Garth还支持更新活动的名称和描述# 更新活动名称 garth.Activity.update(21522899847, name晨跑) # 更新活动描述 garth.Activity.update(21522899847, description今天天气很好跑得很舒服)高级应用数据统计与分析除了原始数据获取Garth还提供了丰富的统计功能帮助你更好地理解健康数据。压力数据统计可以获取每日或每周的压力数据统计# 获取每日压力数据 daily_stress garth.DailyStress.list(2023-07-23, 2) for stress in daily_stress: print(f{stress.calendar_date}: 平均压力 {stress.avg_stress_level}最大压力 {stress.max_stress_level}) # 获取每周压力数据 weekly_stress garth.WeeklyStress.list(2023-07-23, 2)步数统计获取每日或每周的步数统计# 获取最近7天的步数 daily_steps garth.DailySteps.list(period7) for steps in daily_steps: print(f{steps.calendar_date}: {steps.total_steps} 步) # 获取每周步数统计 weekly_steps garth.WeeklySteps.list(period2)训练状态分析Garth提供了训练状态分析功能帮助你了解训练负荷和恢复情况# 获取每日训练状态 daily_training garth.DailyTrainingStatus.list(2025-06-11, 1) print(f训练状态: {daily_training[0].status}) print(f训练负荷: {daily_training[0].acute_training_load}) # 获取每周训练状态 weekly_training garth.WeeklyTrainingStatus.list(2025-06-11, 4)常见问题与解决方案如何处理API请求限制Garmin Connect API有请求频率限制。如果遇到请求失败可以尝试增加请求间隔或使用缓存机制。Garth提供了自动缓存功能可以通过配置启用garth.configure(cacheTrue, cache_ttl3600) # 缓存1小时如何处理MFA登录问题如果你的账户启用了MFA可以使用以下方法登录result1, result2 garth.login(email, password, return_on_mfaTrue) # 手动输入MFA验证码 mfa_code input(Enter MFA code: ) garth.resume_login(result2, mfa_code)如何获取更多类型的健康数据Garth支持多种健康数据类型包括体重、身体成分、 hydration等。例如获取体重数据weight_data garth.WeightData.get(2025-06-15) print(f体重: {weight_data.weight} kg) print(fBMI: {weight_data.bmi}) print(f体脂率: {weight_data.body_fat}%)总结与展望通过本教程你已经了解了如何使用Garth获取Garmin健康数据包括睡眠、心率和活动数据。Garth提供了简洁易用的API让健康数据的获取和分析变得简单高效。随着健康意识的提高个人健康数据的价值越来越受到重视。Garth作为一款开源工具为开发者和健康爱好者提供了强大的数据获取能力。未来Garth还将支持更多类型的健康数据和更丰富的分析功能帮助用户更好地理解和管理自己的健康状况。如果你对Garth感兴趣欢迎参与项目的开发和贡献。项目的源代码托管在src/garth/你可以通过提交issue或pull request来帮助改进Garth。让我们一起打造更强大的健康数据工具【免费下载链接】garth[DEPRECATED] Garmin SSO auth Connect Python client项目地址: https://gitcode.com/gh_mirrors/ga/garth创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考