إنّ واجهات برمجة تطبيقات Google Fit، بما في ذلك Google Fit REST API، لن تعود متاحة بعد 30 حزيران (يونيو) 2025. اعتبارًا من 1 أيار (مايو) 2024، لن يتمكّن المطوّرون من الاشتراك لاستخدام واجهات برمجة التطبيقات هذه.

للحصول على تعليمات حول واجهة برمجة التطبيقات أو المنصة المطلوب نقل البيانات إليها، انتقِل إلى دليل نقل البيانات إلى Health Connect. للمقارنة بين Health Connect وواجهات برمجة تطبيقات Google Fit وواجهات برمجة تطبيقات الويب Fitbit، يُرجى الانتقال إلى دليل المقارنة في Health Connect.

تعرَّف على مزيد من المعلومات حول Health Connect وكيفية الدمج مع واجهة برمجة التطبيقات.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

أنواع بيانات الموقع الجغرافي

أنواع البيانات الخاصة ببيانات الموقع الجغرافي.

عدد اللفّات في الدقيقة على عجلة ركوب الدرّاجة

إذا كان المستخدم يركب الدراجة، يمكن استخدام نوع البيانات هذا لتسجيل دورات العجلة في الدقيقة (RPM). تمثل كل نقطة بيانات قياسًا لحظيًا لدورات العجلة، لذلك يجب تعيين وقت الانتهاء فقط. سيتم استخدام هذا كطابع زمني للقراءة.

راحة

الاسم	`com.google.cycling.wheel_revolution.rpm`
نطاقات أذونات OAuth	https://www.googleapis.com/auth/fitness.location.read https://www.googleapis.com/auth/fitness.location.write
الحقول (التنسيق—الوحدات)	rpm (`float`—rpm) عدد دورات عجلة الدراجة في الدقيقة.

Android

الاسم	`com.google.cycling.wheel_revolution.rpm`
كائن نوع البيانات	`TYPE_CYCLING_WHEEL_RPM`
الحقول (التنسيق—الوحدات)	FIELD_RPM (عدد الدورات في الدقيقة: `float`) عدد دورات عجلة الدراجة في الدقيقة.

ثورة عجلة الدراجة التراكمية

إذا بدأ المستخدم ركوب الدراجة، يمكن استخدام نوع البيانات هذا لتسجيل عدد دورات العجلة على مدار فترة زمنية. تمثل كل نقطة بيانات عدد الدورات منذ العدد في وقت البدء.

راحة

الاسم	`com.google.cycling.wheel_revolution.cumulative`
نطاقات أذونات OAuth	https://www.googleapis.com/auth/fitness.location.read https://www.googleapis.com/auth/fitness.location.write
الحقول (التنسيق—الوحدات)	عدد الدورات: (`int`—العدد) عدد دورات عجلة الدراجة.

Android

الاسم	`com.google.cycling.wheel_revolution.cumulative`
كائن نوع البيانات	`TYPE_CYCLING_PEDALING_CUMULATIVE`
الحقول (التنسيق—الوحدات)	FIELD_REVOLUTIONS (عدد مرات الظهور: `int`) عدد دورات عجلة الدراجة.

دلتا المسافة

يسجل نوع البيانات هذا المسافة التي يقطعها المستخدم منذ آخر قراءة، بالمتر. يمكن حساب المسافة الإجمالية خلال فترة ما من خلال جمع كل القيم معًا خلال هذا الفاصل. يجب أن يمثل وقت البدء لكل نقطة بيانات بداية الفاصل الزمني الذي غطت فيه المسافة. يجب أن يكون وقت البدء مساويًا لوقت الانتهاء لنقطة البيانات السابقة أو أكبر منه.

راحة

الاسم	`com.google.distance.delta`
نطاقات أذونات OAuth	https://www.googleapis.com/auth/fitness.location.read https://www.googleapis.com/auth/fitness.location.write
الحقول (التنسيق—الوحدات)	المسافة (`float` — متر) المسافة التي يتم قطعها بالمتر. النطاق الصالح: من 0 إلى 100 متر في الثانية

Android

الاسم	`com.google.distance.delta`
كائن نوع البيانات	`TYPE_DISTANCE_DELTA`
أذونات Android	`ACCESS_FINE_LOCATION` و`ACTIVITY_RECOGNITION`
الحقول (التنسيق—الوحدات)	FIELD_DISTANCE (عدد الأمتار: `float`) المسافة التي يتم قطعها بالمتر. النطاق الصالح: من 0 إلى 100 متر في الثانية

نموذج الموقع الجغرافي

ويلتقط نوع البيانات هذا الموقع الجغرافي للمستخدم. نظرًا لأن كل نقطة بيانات تمثل موقع المستخدم في وقت القراءة، فيجب تعيين وقت الانتهاء فقط. سيتم استخدامه كطابع زمني للقراءة.

راحة

الاسم com.google.location.sample

نطاقات أذونات OAuth

https://www.googleapis.com/auth/fitness.location.read

https://www.googleapis.com/auth/fitness.location.write

الحقول (التنسيق—الوحدات)

خط العرض (float—درجة)

تمثّل هذه السمة خط العرض لموقع بالدرجات.

النطاق الصالح: من -90 إلى 90 درجة

longitude (float—درجة)

خط الطول لموقع بالدرجات.

النطاق الصالح: من 180 إلى 180 درجة

الدقة (float — متر)

"نصف قطر الدقة" المقدَّر الذي سيكون ضمنه الموقع الجغرافي بالمتر. على سبيل المثال، إذا رسمت دائرة حول هذا الموقع الجغرافي لها نصف قطر يساوي الدقة، يجب أن تكون هناك فرصة بنسبة %68 أن يكون الموقع الجغرافي الفعلي للمستخدم داخل الدائرة فقط. يُستخدم هذا التقدير في الدقة الأفقية فقط. ولا يشير إلى دقة الاتجاه أو السرعة أو الارتفاع (إذا كانت هذه البيانات مضمنة في هذا الموقع الجغرافي). وإذا لم تكن هناك دقة أفقية لهذا الموقع الجغرافي، يتم عرض 0.0.

النطاق الصالح: من 0 إلى 10,000 متر

الارتفاع (float — متر)

ارتفاع الموقع الجغرافي عن مستوى سطح البحر بالمتر

النطاق الصالح: من 100,000 إلى 100,000 متر

Android

الاسم com.google.location.sample

كائن نوع البيانات TYPE_LOCATION_SAMPLE

إذن Android ACCESS_FINE_LOCATION

الحقول (التنسيق—الوحدات)

FIELD_LATITUDE (float—درجة)

تمثّل هذه السمة خط العرض لموقع بالدرجات.

النطاق الصالح: من -90 إلى 90 درجة

FIELD_LONGITUDE (float — درجة)

خط الطول لموقع بالدرجات.

النطاق الصالح: من 180 إلى 180 درجة

FIELD_ACCURACY (float — متر)

النطاق الصالح: من 0 إلى 10,000 متر

FIELD_ALTITUDE (float - متر)

ارتفاع الموقع الجغرافي عن مستوى سطح البحر بالمتر

النطاق الصالح: من 100,000 إلى 100,000 متر

السرعة

نوع البيانات هذا يسجّل سرعة المستخدم بالمتر في الثانية. تمثل القيمة المقدار العددي للسرعة، لذلك يجب ألا تحدث القيم السالبة. نظرًا لأن كل نقطة بيانات تمثل السرعة في وقت القراءة، يجب تعيين وقت الانتهاء فقط. سيتم استخدامه كطابع زمني للقراءة.

راحة

الاسم	`com.google.speed`
نطاقات أذونات OAuth	https://www.googleapis.com/auth/fitness.location.read https://www.googleapis.com/auth/fitness.location.write
الحقول (التنسيق—الوحدات)	السرعة (`float`: متر في الثانية) سرعة الانتقال النطاق الصالح: من 0 إلى 11,000 متر في الثانية

Android

الاسم	`com.google.speed`
كائن نوع البيانات	`TYPE_SPEED`
إذن Android	`ACCESS_FINE_LOCATION`
الحقول (التنسيق—الوحدات)	السرعة (`float`: متر في الثانية) سرعة الانتقال النطاق الصالح: من 0 إلى 11,000 متر في الثانية