python-garminconnect核心功能揭秘：105+API接口让你的健康数据尽在掌握

【免费下载链接】python-garminconnect Python 3 API wrapper for Garmin Connect to get activity statistics 项目地址: https://gitcode.com/gh_mirrors/py/python-garminconnect

python-garminconnect是一个强大的Python 3 API包装器，专为Garmin Connect打造，让你轻松获取和管理健康与健身数据。通过这个工具，开发者可以便捷地访问Garmin Connect平台上的各类健康指标、活动记录和设备信息，实现健康数据的个性化管理与分析。

为什么选择python-garminconnect？

全面覆盖健康数据类型

python-garminconnect提供了105+个API接口，全面覆盖各类健康与健身数据，包括：

• 日常活动数据：步数、楼层、强度分钟数等
• 生理指标：心率、血氧、呼吸频率、压力水平等
• 睡眠分析：睡眠阶段、睡眠质量、醒来次数等
• 身体成分：体重、体脂率、肌肉质量等
• 活动记录：跑步、骑行、游泳等各类运动数据

简单易用的接口设计

该库采用直观的方法命名，让开发者可以轻松理解和使用各个API接口。例如：

• 获取日常步数数据：get_steps_data(cdate)
• 获取心率数据：get_heart_rates(cdate)
• 获取睡眠数据：get_sleep_data(cdate)
• 获取身体成分数据：get_body_composition(startdate, enddate)

灵活的日期范围查询

支持按日、周等不同时间维度查询数据，满足不同场景的需求：

• 日级数据：get_stats(cdate)
• 周级数据：get_weekly_steps(end, weeks=52)
• 日期范围数据：get_daily_steps(start, end)

核心功能模块详解

健康指标追踪

通过丰富的API接口，你可以轻松获取各类健康指标数据：

• 身体电池状态：get_body_battery(cdate) - 了解你的能量水平变化
• 心率变异性：get_hrv_data(cdate) - 评估自主神经系统健康状况
• 训练准备度：get_training_readiness(cdate) - 科学安排训练计划
• 压力水平：get_all_day_stress(cdate) - 监控全天压力变化

活动数据管理

无论是日常活动还是专项训练，都能全面记录和分析：

• 活动列表：get_activities(limit, start) - 获取活动历史记录
• 活动详情：get_activity_details(activity_id) - 深入了解单次活动数据
• 训练状态：get_training_status(cdate) - 评估当前训练效果
• 个人记录：get_personal_record() - 查看各项运动的个人最佳成绩

设备管理

与Garmin设备无缝连接，获取设备信息和设置：

• 设备列表：get_devices() - 查看已连接的Garmin设备
• 设备设置：get_device_settings(device_id) - 获取设备配置信息
• 太阳能数据：get_device_solar_data(device_id, cdate) - 查看太阳能充电情况

快速开始使用指南

安装步骤

通过pip即可轻松安装python-garminconnect：

pip install garminconnect

基本使用示例

以下是一个简单的示例，展示如何连接Garmin Connect并获取健康数据：

from garminconnect import Garmin

# 登录Garmin Connect
api = Garmin("your_email@example.com", "your_password")
api.login()

# 获取今日统计数据
today_stats = api.get_stats("2023-10-05")
print(f"今日步数: {today_stats['steps']}")
print(f"消耗卡路里: {today_stats['calories']}")

# 获取心率数据
heart_rates = api.get_heart_rates("2023-10-05")
print(f"静息心率: {heart_rates['restingHeartRate']}")

# 获取睡眠数据
sleep_data = api.get_sleep_data("2023-10-04")
print(f"睡眠时长: {sleep_data['sleepDuration']/3600:.1f}小时")

# 登出
api.logout()

高级功能示例

python-garminconnect还提供了更多高级功能，如 workout 管理、训练计划等：

# 获取训练计划
training_plan = api.get_training_plan_by_id(plan_id)

# 创建自定义 workout
from garminconnect.workout import Workout, WorkoutStep

workout = Workout()
workout.name = "早晨跑步训练"
workout.add_step(WorkoutStep(
    type="warmup",
    duration=5,
    duration_type="minutes",
    intensity=60
))
# 添加更多训练步骤...

# 上传 workout 到 Garmin Connect
api.create_workout(workout.to_dict())

实用工具与资源

示例程序

项目提供了多个示例程序，帮助你快速上手：

• 简单示例：example.py - 展示基本API使用方法
• 完整演示：demo.py - 全面展示各类功能的使用

测试数据

项目包含多种测试数据，方便开发和调试：

• test_data/sample_activity.gpx - 示例GPX活动文件
• test_data/sample_workout.json - 示例训练计划
• 多种运动类型的示例训练：test_data/sample_running_workout.py、test_data/sample_cycling_workout.py等

总结

python-garminconnect为开发者提供了一个强大而灵活的工具，通过105+个API接口，让你能够轻松访问和管理Garmin Connect平台上的各类健康与健身数据。无论你是想构建个人健康管理应用，还是开发专业的运动分析工具，python-garminconnect都能满足你的需求。

开始使用python-garminconnect，探索你的健康数据，开启科学健身之旅吧！

要开始使用，请克隆仓库：

git clone https://gitcode.com/gh_mirrors/py/python-garminconnect

然后参考项目文档和示例代码，快速集成到你的项目中。

【免费下载链接】python-garminconnect Python 3 API wrapper for Garmin Connect to get activity statistics 项目地址: https://gitcode.com/gh_mirrors/py/python-garminconnect