APIهای Google Fit، از جمله Google Fit REST API، پس از 30 ژوئن 2025 دیگر در دسترس نخواهند بود . از 1 می 2024، توسعه دهندگان نمی توانند برای استفاده از این API ها ثبت نام کنند .
برای دادههایی که میتوانند بهطور مداوم ثبت شوند (با چندین نقطه داده در یک دوره زمانی)، پلتفرم Google Fit میتواند این دادهها را جمعآوری کند و نتایج محاسبهشده را برگرداند. این می تواند یک اندازه گیری متوسط یا یک خلاصه / کل باشد. میتوانید در این محاسبات در زمان صرفهجویی کنید و با خواندن دادههای جمعآوری شده، خلاصهها یا میانگینهای مفید را به کاربران برنامهتان نشان دهید.
برای خواندن دادههای انبوه، باید نوع داده، محدوده زمانی و چیزی را انتخاب کنید تا دادهها را بر اساس «سطل» (یا گروهبندی) کنید. می توانید داده ها را به چند روش مختلف سطل کنید:
دوره زمانی
داده های انباشته شده را بر حسب ساعت یا روز جمع آوری کنید. برای مثال، مراحل یا کالری سوزانده شده در روز را ببینید.
نوع فعالیت
داده های انباشته شده را بر اساس نوع فعالیت جمع آوری کنید. به عنوان مثال، برای داده های خواب بیش از یک هفته، یک سطل برای هر نوع فعالیت خواب (سبک، عمیق و REM) وجود خواهد داشت.
بخش فعالیت
داده های انباشته شده را بر اساس بخش های فعالیت در یک دوره زمانی جمع آوری کنید. به عنوان مثال، اگر کاربری بین ساعت 9 صبح تا 10 صبح برای دویدن رفت اما 20 دقیقه اول بدود، 10 دقیقه بنشیند، 15 دقیقه راه برود و 15 دقیقه بدود، اینها 4 بخش فعالیت محسوب می شوند و 4 سطل را برمی گرداند.
جلسه
از مرزهای زمانی جلسات برای جمع آوری داده ها استفاده کنید. به عنوان مثال، اگر کاربر برای 2 اجرا رفت که به عنوان 2 جلسه ثبت شده بود (یک دویدن صبح و یک بعد از ظهر)، می توانید سطل به جلسه برای یادگیری میانگین گام ها یا سرعت متوسط هر اجرا.
فعالیت
از این نوع داده ها برای خواندن داده های انبوه سلامت و تندرستی استفاده کنید.
خلاصه فعالیت
کل زمان و تعداد بخش ها برای یک فعالیت خاص در یک دوره زمانی. هر نقطه داده خلاصه ای از تمام بخش های فعالیت را برای یک نوع فعالیت خاص در یک بازه زمانی نشان می دهد.
کل زمان صرف شده برای یک فعالیت در همه بخشها در محدوده زمانی.
FIELD_NUM_SEGMENTS ( int - تعداد)
تعداد بخشهای فعالیت متمایز در بازه زمانی این نقطه داده.
خلاصه نرخ متابولیسم پایه (BMR).
هر نقطه داده نشان دهنده میانگین، حداکثر و حداقل میزان متابولیسم پایه کاربر در بازه زمانی، بر حسب کیلو کالری در روز است. این در صورتی مفید است که کاربر وزن اضافه یا کاهش داده باشد و بنابراین BMR وی تغییر کرده باشد.
میانگین توان تولید شده کاربر در طول دوره زمانی، بر حسب وات.
حداکثر ( float - وات)
حداکثر توان تولید شده کاربر در طول دوره زمانی، بر حسب وات.
دقیقه ( float - وات)
حداقل توان تولید شده کاربر در طول دوره زمانی، بر حسب وات.
اندروید
نام
com.google.power.summary
شی نوع داده
AGGREGATE_POWER_SUMMARY
فیلدها (فرمت-واحدها)
FIELD_AVERAGE ( float — وات)
میانگین توان تولید شده کاربر در طول دوره زمانی، بر حسب وات.
FIELD_MAX ( float — وات)
حداکثر توان تولید شده کاربر در طول دوره زمانی، بر حسب وات.
FIELD_MIN ( float — وات)
حداقل توان تولید شده کاربر در طول دوره زمانی، بر حسب وات.
خلاصه دلتا شمارش گام
هر نقطه داده نشان دهنده تعداد کل مراحل در طول دوره زمانی است. این نوع داده و فیلدهای آن مانند نوع داده آنی است.
بدن
از این نوع داده ها برای خواندن داده های جمع آوری اندازه گیری بدن استفاده کنید.
خلاصه درصد چربی بدن
هر نقطه داده نشان دهنده میانگین، حداکثر و حداقل درصد چربی بدن کاربر در یک دوره زمانی است.
استراحت
نام
com.google.body.fat.percentage.summary
محدوده های مجوز OAuth
https://www.googleapis.com/auth/fitness.body.read
فیلدها (فرمت-واحدها)
متوسط ( float - درصد)
میانگین درصد کل توده بدن کاربر که چربی بدن است، در یک دوره زمانی.
حداکثر ( float - درصد)
حداکثر درصد توده کل بدن کاربر که چربی بدن است، در یک دوره زمانی.
دقیقه ( float - درصد)
حداقل درصد توده کل بدن کاربر که چربی بدن است، در یک دوره زمانی.
اندروید
نام
com.google.body.fat.percentage.summary
شی نوع داده
AGGREGATE_BODY_FAT_PERCENTAGE_SUMMARY
فیلدها (فرمت-واحدها)
FIELD_AVERAGE ( float — درصد)
میانگین درصد کل توده بدن کاربر که چربی بدن است، در یک دوره زمانی.
FIELD_MAX ( float — درصد)
حداکثر درصد توده کل بدن کاربر که چربی بدن است، در یک دوره زمانی.
FIELD_MIN ( float – درصد)
حداقل درصد توده کل بدن کاربر که چربی بدن است، در یک دوره زمانی.
خلاصه ضربان قلب
هر نقطه داده نشان دهنده میانگین، حداکثر و حداقل ضربان قلب کاربر در بازه زمانی، بر حسب ضربان در دقیقه است.
استراحت
نام
com.google.heart_rate.summary
محدوده های مجوز OAuth
https://www.googleapis.com/auth/fitness.body.read
فیلدها (فرمت-واحدها)
متوسط ( float - bpm)
میانگین ضربان قلب کاربر بر حسب ضربان در دقیقه، در یک دوره زمانی.
حداکثر ( float - bpm)
حداکثر ضربان قلب کاربر بر حسب ضربان در دقیقه، در یک دوره زمانی.
دقیقه ( float - bpm)
حداقل ضربان قلب کاربر بر حسب ضربان در دقیقه، در یک دوره زمانی.
اندروید
نام
com.google.heart_rate.summary
شی نوع داده
AGGREGATE_HEART_RATE_SUMMARY
فیلدها (فرمت-واحدها)
FIELD_AVERAGE ( float — bpm)
میانگین ضربان قلب کاربر بر حسب ضربان در دقیقه، در یک دوره زمانی.
FIELD_MAX ( float — bpm)
حداکثر ضربان قلب کاربر بر حسب ضربان در دقیقه، در یک دوره زمانی.
FIELD_MIN ( float — bpm)
حداقل ضربان قلب کاربر بر حسب ضربان در دقیقه، در یک دوره زمانی.
خلاصه قد
هر نقطه داده میانگین، حداکثر و حداقل ارتفاع کاربر را در یک دوره زمانی، بر حسب متر نشان می دهد.
استراحت
نام
com.google.height.summary
محدوده های مجوز OAuth
https://www.googleapis.com/auth/fitness.body.read
فیلدها (فرمت-واحدها)
متوسط (متر float )
میانگین قد کاربر در یک دوره زمانی، بر حسب متر.
حداکثر (متر float )
حداکثر ارتفاع کاربر در یک بازه زمانی، بر حسب متر.
دقیقه ( float - متر)
حداقل ارتفاع کاربر در یک دوره زمانی، بر حسب متر.
اندروید
نام
com.google.height.summary
شی نوع داده
AGGREGATE_HEIGHT_SUMMARY
فیلدها (فرمت-واحدها)
FIELD_AVERAGE ( float — متر)
میانگین قد کاربر در یک دوره زمانی، بر حسب متر.
FIELD_MAX ( float — متر)
حداکثر ارتفاع کاربر در یک بازه زمانی، بر حسب متر.
FIELD_MIN ( float — متر)
حداقل ارتفاع کاربر در یک دوره زمانی، بر حسب متر.
خلاصه وزن
هر نقطه داده نشان دهنده میانگین، حداکثر و حداقل وزن کاربر در یک بازه زمانی، بر حسب کیلوگرم است.
استراحت
نام
com.google.weight.summary
محدوده های مجوز OAuth
https://www.googleapis.com/auth/fitness.body.read
فیلدها (فرمت-واحدها)
متوسط ( float - کیلوگرم)
میانگین وزن بدن کاربر در یک دوره زمانی، بر حسب کیلوگرم.
حداکثر ( float - کیلوگرم)
حداکثر وزن بدن کاربر در یک بازه زمانی، بر حسب کیلوگرم.
دقیقه ( float - کیلوگرم)
حداقل وزن بدن کاربر در یک بازه زمانی، بر حسب کیلوگرم.
اندروید
نام
com.google.weight.summary
شی نوع داده
AGGREGATE_WEIGHT_SUMMARY
فیلدها (فرمت-واحدها)
FIELD_AVERAGE ( float — کیلوگرم)
میانگین وزن بدن کاربر در یک دوره زمانی، بر حسب کیلوگرم.
FIELD_MAX ( float — کیلوگرم)
حداکثر وزن بدن کاربر در یک بازه زمانی، بر حسب کیلوگرم.
FIELD_MIN ( float — کیلوگرم)
حداقل وزن بدن کاربر در یک بازه زمانی، بر حسب کیلوگرم.
مکان
از این انواع داده برای خواندن داده های مکان انبوه استفاده کنید.
دلتای فاصله
هر نقطه داده کل مسافت پیموده شده کاربر در یک دوره زمانی را بر حسب متر نشان می دهد. این نوع داده و فیلدهای آن مانند نوع داده آنی است.
جعبه مرزبندی مکان
هر نقطه داده نشان دهنده جعبه مرزی است که بر روی نقاط مکان کاربر در یک دوره زمانی محاسبه شده است. هر جعبه مرزی دارای چهار فیلد است که نشان دهنده چهار گوشه جعبه مرزی است.
میانگین سرعت کاربر در یک بازه زمانی، بر حسب متر بر ثانیه.
حداکثر ( float - متر در ثانیه)
حداکثر سرعت کاربر در یک بازه زمانی، بر حسب متر بر ثانیه.
دقیقه ( float - متر در ثانیه)
حداقل سرعت کاربر در یک بازه زمانی، بر حسب متر بر ثانیه.
اندروید
نام
com.google.speed.summary
شی نوع داده
AGGREGATE_SPEED_SUMMARY
فیلدها (فرمت-واحدها)
میانگین ( float - متر در ثانیه)
میانگین سرعت کاربر در یک بازه زمانی، بر حسب متر بر ثانیه.
حداکثر ( float - متر در ثانیه)
حداکثر سرعت کاربر در یک بازه زمانی، بر حسب متر بر ثانیه.
دقیقه ( float - متر در ثانیه)
حداقل سرعت کاربر در یک بازه زمانی، بر حسب متر بر ثانیه.
تغذیه
از این نوع داده ها برای خواندن داده های تغذیه انباشته استفاده کنید.
خلاصه هیدراتاسیون
هر نقطه داده نشان دهنده حجم کل آب مصرف شده توسط کاربر در یک دوره زمانی، بر حسب لیتر است. این نوع داده و فیلدهای آن مانند نوع داده آنی است.
خلاصه تغذیه
هر نقطه داده نشان دهنده مجموع تمام ورودی های تغذیه در یک دوره زمانی است. در قسمت مواد مغذی، هر مقدار نشان دهنده مجموع ماده مغذی در تمام ورودیها در دوره زمانی است.
اگر ماده مغذی در هیچ یک از ورودی ها نبود، در نقشه کل نیز وجود نخواهد داشت. اگر همه ورودیها در بازه زمانی برای یک وعده غذایی باشند، نوع غذا نیز تنظیم میشود.
کل مواد مغذی موجود در غذای مصرف شده در یک دوره زمانی.
ارزش های پذیرفته شده
"key": "calories" // Calories in kcal
"key": "fat.total" // Total fat in grams
"key": "fat.saturated" // Saturated fat in grams
"key": "fat.unsaturated" // Unsaturated fat in grams
"key": "fat.polyunsaturated" // Polyunsaturated fat in grams
"key": "fat.monounsaturated" // Monounsaturated fat in grams
"key": "fat.trans" // Trans fat in grams
"key": "cholesterol" // Cholesterol in milligrams
"key": "sodium" // Sodium in milligrams
"key": "potassium" // Potassium in milligrams
"key": "carbs.total" // Total carbohydrates in grams
"key": "dietary_fiber" // Dietary fiber in grams
"key": "sugar" // Amount of sugar in grams
"key": "protein" // Protein amount in grams
اندروید
نام
com.google.nutrition.summary
شی نوع داده
AGGREGATE_NUTRITION_SUMMARY
فیلدها (فرمت-واحدها)
FIELD_MEAL_TYPE ( int — enum)
کاربر چه نوع غذایی خورده است (اگر همه مطالب در بازه زمانی مربوط به یک وعده غذایی باشد، ارائه شود).
کل مواد مغذی موجود در غذای مصرف شده در یک دوره زمانی.
ارزش های پذیرفته شده
NUTRIENT_CALORIES // Calories in kcal
NUTRIENT_TOTAL_FAT // Total fat in grams
NUTRIENT_SATURATED_FAT // Saturated fat in grams
NUTRIENT_UNSATURATED_FAT // Unsaturated fat in grams
NUTRIENT_POLYUNSATURATED_FAT // Polyunsaturated fat in grams
NUTRIENT_MONOUNSATURATED_FAT // Monounsaturated fat in grams
NUTRIENT_TRANS_FAT // Trans fat in grams
NUTRIENT_CHOLESTEROL // Cholesterol in milligrams
NUTRIENT_SODIUM // Sodium in milligrams
NUTRIENT_POTASSIUM // Potassium in milligrams
NUTRIENT_TOTAL_CARBS // Total carbohydrates in grams
NUTRIENT_DIETARY_FIBER // Dietary fiber in grams
NUTRIENT_SUGAR // Amount of sugar in grams
NUTRIENT_PROTEIN // Protein amount in grams
سلامتی
از این نوع داده ها برای خواندن داده های پزشکی و بهداشتی جمع آوری شده استفاده کنید.
خلاصه گلوکز خون
هر نقطه داده نشاندهنده میانگین، حداقل و حداکثر سطح یا غلظت گلوکز خون در محدوده زمانی است که بر حسب میلیمول در لیتر اندازهگیری میشود که در آن 1 میلیمول در لیتر 18 میلیگرم در دسیلیتر است.
اگر مقادیر هر یک از این فیلدها برای همه اندازهگیریهای انجامشده در بازه زمانی یکسان باشد، مقدار فیلد را در دادههای برگشتی مشاهده خواهید کرد:
رابطه زمانی با یک وعده غذایی
رابطه زمانی با خواب
منبع نمونه
اگر مقادیر در اندازهگیریها متفاوت باشد، فیلد حذف میشود.
میانگین سطح یا غلظت گلوکز خون کاربر در یک دوره زمانی.
حداکثر ( float -mmol/L)
حداکثر سطح یا غلظت گلوکز خون کاربر در یک دوره زمانی.
دقیقه ( float —mmol/L)
حداقل سطح یا غلظت گلوکز خون کاربر در یک دوره زمانی.
رابطه زمانی با وعده غذایی ( int —enum) (فیلد اختیاری)
زمانی که خواندن در مقایسه با زمانی که کاربر غذا می خورد گرفته شد.
ارزش های پذیرفته شده
"intVal": 1 // Reading wasn't taken before or after a meal
"intVal": 2 // Reading was taken during a fasting period
"intVal": 3 // Reading was taken before a meal
"intVal": 4 // Reading was taken after a meal
زمانی که خواندن در مقایسه با زمانی که کاربر خواب بود گرفته شد.
ارزش های پذیرفته شده
"intVal": 1 // User was fully awake
"intVal": 2 // Before the user fell asleep
"intVal": 3 // After the user woke up
"intVal": 4 // While the user was still sleeping
منبع نمونه ( int —enum) (فیلد اختیاری)
نوع مایع بدن که برای اندازه گیری گلوکز خون استفاده می شود.
میانگین سطح یا غلظت گلوکز خون کاربر در یک دوره زمانی.
FIELD_MAX ( float —mmol/L)
حداکثر سطح یا غلظت گلوکز خون کاربر در یک دوره زمانی.
FIELD_MIN ( float —mmol/L)
حداقل سطح یا غلظت گلوکز خون کاربر در یک دوره زمانی.
FIELD_TEMPORAL_RELATION_TO_MEAL ( int —enum) (فیلد اختیاری)
زمانی که خواندن در مقایسه با زمانی که کاربر غذا می خورد گرفته شد.
ارزش های پذیرفته شده
FIELD_TEMPORAL_RELATION_TO_MEAL_GENERAL // Reading wasn't taken before or after a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_FASTING // Reading was taken during a fasting period
FIELD_TEMPORAL_RELATION_TO_MEAL_BEFORE_MEAL // Reading was taken before a meal
FIELD_TEMPORAL_RELATION_TO_MEAL_AFTER_MEAL // Reading was taken after a meal
FIELD_TEMPORAL_RELATION_TO_SLEEP ( int —enum) (فیلد اختیاری)
زمانی که خواندن در مقایسه با زمانی که کاربر خواب بود گرفته شد.
ارزش های پذیرفته شده
TEMPORAL_RELATION_TO_SLEEP_FULLY_AWAKE // User was fully awake.
TEMPORAL_RELATION_TO_SLEEP_BEFORE_SLEEP // Before the user fell asleep.
TEMPORAL_RELATION_TO_SLEEP_ON_WAKING // After the user woke up.
TEMPORAL_RELATION_TO_SLEEP_DURING_SLEEP // While the user was still sleeping.
FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE ( int — enum) (فیلد اختیاری)
نوع مایع بدن که برای اندازه گیری گلوکز خون استفاده می شود.
BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining
FIELD_BLOOD_PRESSURE_MEASUREMENT_LOCATION ( int — enum) (فیلد اختیاری)
کدام بازو و قسمتی از بازو اندازه گیری شد.
ارزش های پذیرفته شده
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_WRIST // Left wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_WRIST // Right wrist
BLOOD_PRESSURE_MEASUREMENT_LOCATION_LEFT_UPPER_ARM // Left upper arm
BLOOD_PRESSURE_MEASUREMENT_LOCATION_RIGHT_UPPER_ARM // Right upper arm
خلاصه دمای بدن
هر نقطه داده نشان دهنده میانگین، حداقل و حداکثر دمای بدن کاربر در یک بازه زمانی است.
در صورتی که مکان اندازه گیری برای همه نقاط داده در بازه زمانی یکسان بود، همچنین مکانی را خواهد داشت که اندازه گیری روی بدنه انجام شده است.
تاریخ آخرین بهروزرسانی 2024-11-14 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-11-14 بهوقت ساعت هماهنگ جهانی."],[[["Google Fit uses aggregate data types to provide summaries of health and wellness metrics, like steps, calories, and heart rate, over specific time periods."],["Developers can retrieve aggregated data by specifying the data type, time range, and how the data should be grouped (e.g., by time period, activity type, or session)."],["Data is categorized into activity, body, and location, each with specific data types and fields providing aggregated values like totals, averages, minimums, and maximums."],["Aggregate data types are read-only, meaning you can only retrieve data, not write or modify it."],["Accessing aggregate data types requires appropriate OAuth permissions, and Google Fit offers both REST and Android APIs for retrieval."]]],[]]