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

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

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

إذا كان المستخدم يركب دراجة، يمكن استخدام نوع البيانات هذا لتسجيل عدد دورات العجلة في الدقيقة (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
أذونات AndroidACCESS_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
إذن AndroidACCESS_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
إذن AndroidACCESS_FINE_LOCATION
الحقول (التنسيق—الوحدات) السرعة (float—متر في الثانية)
سرعة التنقّل
النطاق الصالح: من 0 إلى 11,000 متر في الثانية