تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
بالنسبة إلى البيانات التي يمكن تسجيلها باستمرار (مع نقاط بيانات متعددة على مدار فترة زمنية معيّنة)، يمكن لنظام Google Fit الأساسي تجميع هذه البيانات وعرض النتائج المحسوبة. يمكن أن يتمثل ذلك في متوسط القياس أو ملخّص/إجمالي. يمكنك توفير الوقت الذي تستغرقه هذه العمليات الحسابية وعرض ملخصات أو متوسطات مفيدة لمستخدمي تطبيقك بسهولة من خلال قراءة البيانات المجمّعة.
لقراءة البيانات المجمّعة، تحتاج إلى اختيار نوع البيانات، والنطاق الزمني، وشيء ما 'bucket' (أو مجموعة) البيانات حسبه. يمكنك تجميع البيانات بعدة طرق مختلفة:
الفترة الزمنية
مجموعة البيانات المجمّعة حسب الساعة أو اليوم. مثلاً، يمكنك الاطّلاع على عدد الخطوات أو السعرات الحرارية التي تم حرقها في اليوم.
نوع النشاط
جمع البيانات المجمّعة حسب نوع النشاط على سبيل المثال، بالنسبة إلى بيانات النوم على مدار أسبوع، سيتم استخدام مجموعة بيانات لكل نوع من أنواع النوم (الفاتح والعميق وREM).
شريحة النشاط
مجموعة بيانات مجمّعة حسب شرائح النشاط خلال فترة زمنية. على سبيل المثال، إذا ركض أحد المستخدمين للركض بين 9 صباحًا و10 صباحًا، ثم ركض لمدة أول 20 دقيقة، وجلس لمدة 10 دقائق، ثم سار لمدة 15 دقيقة، وركض لمدة 15 دقيقة، تعتبر هذه 4 شرائح للنشاط وسترجع إلى 4 مجموعات.
الجلسة
استخدِم الحدود الزمنية للجلسات لتجميع البيانات. على سبيل المثال، إذا زار المستخدم جلستَين تم تسجيلهما كجلستَين (جريًا صباحًا وجريًا بعد الظهر)، يمكنك جمع البيانات حسب الجلسة لمعرفة متوسط الخطوات أو متوسط السرعة لكل عملية تشغيل.
النشاط
يمكنك استخدام أنواع البيانات هذه لقراءة البيانات المتعلّقة بالصحة والعافية المجمّعة.
ملخص النشاط
إجمالي الوقت وعدد الشرائح لنشاط معيّن على مدار فترة زمنية معيّنة.
تمثّل كل نقطة بيانات ملخّصًا لكل شرائح النشاط الخاصة بنوع معيّن من الأنشطة على مدار فترة زمنية معيّنة.
نوع النشاط الذي كان يمارسه المستخدم. يمكنك الاطّلاع على قائمة أنواع الأنشطة هنا.
duration (int - ملي ثانية)
إجمالي الوقت المُستغرَق في النشاط على جميع الشرائح في النطاق الزمني.
عدد الشرائح (int—العدد)
عدد شرائح النشاط المختلفة خلال الفاصل الزمني لنقطة البيانات هذه.
Android
الاسم
com.google.activity.summary
كائن نوع البيانات
AGGREGATE_Activity_SUMMARY
الحقول (التنسيق - الوحدات)
FIELD_Activity (int—تعداد)
نوع النشاط الذي كان يمارسه المستخدم. يمكنك الاطّلاع على قائمة أنواع الأنشطة هنا.
FIELD_DURATION (int - مللي ثانية)
إجمالي الوقت المُستغرَق في النشاط على جميع الشرائح في النطاق الزمني.
FIELD_NUM_SEGMENTS (int - العدد)
عدد شرائح النشاط المختلفة خلال الفاصل الزمني لنقطة البيانات هذه.
ملخص معدّل الأيض الأساسي
تمثّل كل نقطة بيانات متوسط الأيض الأساسي للمستخدم والحد الأقصى والحد الأدنى لمعدل الأيض الأساسي خلال النطاق الزمني، بوحدة الكيغالور في اليوم. ويُعدّ هذا الأمر مفيدًا إذا كان المستخدم قد فقد وزنه أو فقده، وبالتالي تم تغيير معدّل التحوّل في السيارة.
تمثّل هذه السمة عدد نقاط القلب المكتسَبة خلال الفترة الزمنية، بما في ذلك النقاط التي تمّ الحصول عليها من المضاعِفات (المزيد من النقاط المكتسبة مقابل ممارسة نشاط أكثر شدّة).
duration (float - دقيقة)
الوقت الذي تم فيه كسب "نقاط القلب"، ويتم قياسه بالدقائق.
Android
الاسم
com.google.heart_minutes.summary
كائن نوع البيانات
AGGREGATE_HEART_POINTS
الحقول (التنسيق - الوحدات)
FIELD_INTENSITY (float - نقاط القلب)
تمثّل هذه السمة عدد نقاط القلب المكتسَبة خلال الفترة الزمنية، بما في ذلك النقاط التي تمّ الحصول عليها من المضاعِفات (المزيد من النقاط المكتسبة مقابل ممارسة نشاط أكثر شدّة).
FIELD_DURATION (float - دقيقة)
الوقت الذي تم فيه كسب "نقاط القلب"، ويتم قياسه بالدقائق.
ملخّص دقائق الحركة
إجمالي عدد دقائق الحركة خلال الفترة الزمنية. هذا النوع من الحقول والحقول هو نفسه لنوع البيانات الفوري.
ملخّص الطاقة
تمثّل كل نقطة بيانات متوسط قيمة المستخدم والحد الأقصى والحد الأدنى لطاقة الطاقة بالواط، خلال فترة زمنية معيّنة.
متوسط طاقة المستخدم التي تم تحقيقها خلال الفترة الزمنية بالواط.
max (float - واط)
الحد الأقصى لطاقة المستخدم التي يتم تحقيقها خلال الفترة الزمنية بالواط.
min (float - واط)
الحد الأدنى لطاقة المستخدم التي يتم تحقيقها خلال الفترة الزمنية بالواط.
Android
الاسم
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 - النسبة المئوية)
النسبة المئوية القصوى لوزن الجسم الكلي للدهون في المستخدم خلال فترة زمنية معيّنة.
min (float - بالمائة)
الحد الأدنى لنسبة إجمالي وزن كُتلة الجسم بالنسبة إلى المستخدم خلال فترة زمنية معيّنة.
Android
الاسم
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)
الحد الأقصى لمعدّل نبضات القلب للمستخدِم في الدقيقة، خلال فترة زمنية
min (float - نبضة في الدقيقة)
الحد الأدنى لمعدّل نبضات القلب للمستخدم في الدقيقة، خلال فترة زمنية
Android
الاسم
com.google.heart_rate.summary
كائن نوع البيانات
AGGREGATE_HEART_RATE_SUMMARY
الحقول (التنسيق - الوحدات)
FIELD_AVERAGE (float - نبضة في الدقيقة)
متوسط معدل نبضات القلب للمستخدم في الدقيقة، خلال فترة زمنية.
FIELD_MAX (float - نبضة في الدقيقة)
الحد الأقصى لمعدّل نبضات القلب للمستخدِم في الدقيقة، خلال فترة زمنية
FIELD_MIN (float—bpm)
الحد الأدنى لمعدّل نبضات القلب للمستخدم في الدقيقة، خلال فترة زمنية
ملخص الارتفاع
تمثّل كل نقطة بيانات متوسط طول المستخدم والحد الأقصى والحد الأدنى للارتفاع خلال فترة زمنية معيّنة بالمتر.
راحة
الاسم
com.google.height.summary
نطاقات أذونات OAuth
https://www.googleapis.com/auth/fitness.body.read
الحقول (التنسيق - الوحدات)
متوسط (float - متر)
متوسط ارتفاع المستخدم خلال فترة زمنية بالمتر.
الحد الأقصى (float - متر)
الحد الأقصى للارتفاع للمستخدم خلال فترة زمنية بالمتر،
min (float - متر)
الحد الأدنى للارتفاع للمستخدم خلال فترة زمنية بالمتر،
Android
الاسم
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—كلغ)
متوسط وزن جسم المستخدم خلال فترة زمنية بالكيلوغرام.
max (float—كلغ)
الحد الأقصى لوزن الجسم للمستخدم خلال فترة زمنية بالكيلوغرام.
min (float—kg)
الحد الأدنى لوزن الجسم للمستخدم خلال فترة زمنية بالكيلوغرام.
Android
الاسم
com.google.weight.summary
كائن نوع البيانات
AGGREGATE_WEIGHT_SUMMARY
الحقول (التنسيق - الوحدات)
FIELD_AVERAGE (float—كلغ)
متوسط وزن جسم المستخدم خلال فترة زمنية بالكيلوغرام.
FIELD_MAX (float—كلغ)
الحد الأقصى لوزن الجسم للمستخدم خلال فترة زمنية بالكيلوغرام.
FIELD_MIN (float—كلغ)
الحد الأدنى لوزن الجسم للمستخدم خلال فترة زمنية بالكيلوغرام.
الموقع الجغرافي
يمكنك استخدام أنواع البيانات هذه لقراءة بيانات الموقع الجغرافي المجمّعة.
دلتا المسافة
تمثل كل نقطة بيانات إجمالي المسافة التي قطعها المستخدم خلال فترة زمنية معيّنة، بالمتر. هذا النوع من البيانات وحقوله متماثلاً مع نوع البيانات الفورية.
مربّع تحديد الموقع الجغرافي
تمثّل كل نقطة بيانات مربّع الربط الذي تم احتسابه خلال نقاط الموقع الجغرافي للمستخدم على مدار فترة زمنية. يحتوي كل مربّع حدود على أربعة حقول تمثّل زواياه الأربعة.
متوسط سرعة المستخدم على مدار فترة زمنية، بالمتر لكل ثانية.
الحد الأقصى (float - متر في الثانية)
تبلغ السرعة القصوى للمستخدم خلال فترة زمنية بالمتر في الثانية.
min (float - متر في الثانية)
الحد الأدنى للسرعة للمستخدم خلال فترة زمنية بالمتر في الثانية
Android
الاسم
com.google.speed.summary
كائن نوع البيانات
AGGREGATE_SPEED_SUMMARY
الحقول (التنسيق - الوحدات)
المتوسط (float - متر في الثانية)
متوسط سرعة المستخدم على مدار فترة زمنية، بالمتر لكل ثانية.
الحد الأقصى (float - متر في الثانية)
تبلغ السرعة القصوى للمستخدم خلال فترة زمنية بالمتر في الثانية.
min (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
Android
الاسم
com.google.nutrition.summary
كائن نوع البيانات
AGGREGATE_NUTRITION_SUMMARY
الحقول (التنسيق - الوحدات)
FIELD_MEAL_TYPE (int—تعداد)
نوع الوجبة التي تناولها المستخدم (تم العثور عليها إذا كانت جميع الإدخالات في الفترة الزمنية تتناول الوجبة نفسها).
إجمالي العناصر الغذائية في الطعام الذي تم تناوله خلال فترة زمنية.
القيم المقبولة
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
ملغ/مل.
إذا كانت قيم كل حقل من هذه الحقول متطابقة مع جميع القياسات التي تم إجراؤها
خلال النطاق الزمني، سترى'قيمة الحقل في البيانات المعروضة:
العلاقة الزمنية بالوجبة
العلاقة المؤقتة بالنوم
مصدر العيّنة
إذا كانت القيم مختلفة في القياسات، سيتم استبعاد الحقل.
متوسط مستوى الجلوكوز في الدم أو تركيز المستخدم خلال فترة زمنية معيّنة.
max (float—mmol/L)
الحد الأقصى لمستوى الغلوكوز في الدم أو التركيز للمستخدم خلال فترة زمنية معيّنة
min (float - mmol/L)
الحد الأدنى لمستوى الغلوكوز في الدم أو تركيز المستخدم خلال فترة زمنية معيّنة.
العلاقة المؤقتة بالوجبة (int—تعداد) (حقل اختياري)
وقت إجراء القراءة مقارنةً بوقت تناول المستخدم للمستخدم
القيم المقبولة
"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—تعداد) (حقل اختياري)
نوع سوائل الجسم المُستخدَمة لقياس نسبة الغلوكوز في الدم.
وقت إجراء القراءة مقارنةً بوقت تناول المستخدم للمستخدم
القيم المقبولة
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
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_body_POSITION (int - تعداد) (حقل اختياري)
موضع نص المستخدِم عند إجراء القياس.
القيم المقبولة
BODY_POSITION_STANDING // Standing up
BODY_POSITION_SITTING // Sitting down
BODY_POSITION_LYING_DOWN // Lying down
BODY_POSITION_SEMI_RECUMBENT // Reclining
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
ملخّص درجة حرارة الجسم
تمثّل كل نقطة بيانات متوسط درجة حرارة الجسم والحد الأدنى والأقصى للمستخدم على مدار نطاق زمني.
سيكون لها أيضًا الموقع الجغرافي الذي تم فيه إجراء القياس على الجسم، إذا كان موقع القياس موحَّدًا لجميع نقاط البيانات في الفاصل الزمني.