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

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

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

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

ملاحظة: تحتاج مصادر البيانات المختلفة إلى مراقبة دورات العجلة لمدد زمنية مختلفة قبل احتساب عدد الدورات في الدقيقة. يجب الإشارة إلى ذلك كجزء من مصدر البيانات، وليس كنقطة بيانات.

REST

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

Android

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

إجمالي عدد دورات عجلة ركوب الدرّاجة

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

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

REST

الاسم	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—عدد) عدد دورات عجلة الدراجة

تغيير المسافة

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

REST

الاسم	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 متر في الثانية

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

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

ملاحظة: لا يمكن قراءة هذه البيانات إلا من خلال التطبيق الذي كتبها. يمكن لتطبيقك قراءة البيانات التي كتبها فقط. ولا يمكنه قراءة بيانات نموذج الموقع الجغرافي التي كتبتها تطبيقات أخرى.

REST

الاسم	com.google.location.sample
نطاقات أذونات OAuth	https://www.googleapis.com/auth/fitness.location.read https://www.googleapis.com/auth/fitness.location.write
الحقول (التنسيق—الوحدات)	latitude (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—متر) تمثّل هذه السمة "نصف قطر الدقة" المقدَّر الذي يقع ضمنه الموقع الجغرافي، وذلك بالمتر. على سبيل المثال، إذا رسمت دائرة حول هذا الموقع الجغرافي بنصف قطر يساوي الدقة، من المفترض أن يكون هناك احتمال بنسبة %68 بأنّ الموقع الجغرافي الحقيقي للمستخدم يقع ضمن الدائرة. هذا التقدير مخصّص للدقة الأفقية فقط. لا تشير هذه السمة إلى دقة الاتجاه أو السرعة أو الارتفاع (إذا كانت هذه البيانات مضمّنة في هذا الموقع الجغرافي). إذا لم يكن لهذا الموقع الجغرافي دقة أفقية، سيتم عرض القيمة 0.0. النطاق الصالح: من 0 إلى 10,000 متر ‫FIELD_ALTITUDE (float—متر) تمثّل هذه السمة ارتفاع الموقع الجغرافي عن مستوى سطح البحر بالمتر. النطاق الصالح: من ‎-100,000 إلى 100,000 متر

السرعة

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

REST

الاسم	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 متر في الثانية