انواع داده های مکان

انواع داده‌ها برای داده‌های مکانی

دور موتور دوچرخه (RPM)

اگر کاربری دوچرخه‌سواری کند، می‌توان از این نوع داده برای ثبت تعداد دور چرخ در دقیقه (RPM) او استفاده کرد. هر نقطه داده نشان‌دهنده‌ی یک اندازه‌گیری لحظه‌ای از دور چرخ است، بنابراین فقط زمان پایان باید تنظیم شود. این به عنوان مهر زمانی برای خواندن استفاده خواهد شد.

توجه: منابع داده مختلف باید قبل از محاسبه RPM لحظه‌ای، چرخش چرخ‌ها را برای مدت زمان‌های مختلفی رصد کنند. این باید به عنوان بخشی از منبع داده، نه نقطه داده، ذکر شود.

استراحت

نام	com.google.cycling.wheel_revolution.rpm
دامنه‌های مجوز OAuth	https://www.googleapis.com/auth/fitness.location.read https://www.googleapis.com/auth/fitness.location.write
فیلدها (قالب — واحدها)	دور در دقیقه ( float —rpm) تعداد دور چرخ‌های دوچرخه در دقیقه.

اندروید

نام	com.google.cycling.wheel_revolution.rpm
شیء نوع داده	TYPE_CYCLING_WHEEL_RPM
فیلدها (قالب — واحدها)	FIELD_RPM ( float -rpm) تعداد دور چرخ‌های دوچرخه در دقیقه.

مجموع دور چرخ دوچرخه

اگر کاربری دوچرخه‌سواری کند، می‌توان از این نوع داده برای ثبت تعداد چرخش‌های چرخ در یک بازه زمانی استفاده کرد. هر نقطه داده نشان دهنده تعداد چرخش‌ها از زمان شمارش در زمان شروع است.

نکته: هر نقطه داده، تعداد کل دورها را از زمان شروع ثبت می‌کند. این دلتا یا تغییر در دورها نیست. بنابراین تعداد دورها در یک بازه زمانی را می‌توان با کم کردن تعداد نهایی در زمان پایان از تعداد اولیه در زمان شروع محاسبه کرد.

استراحت

نام	com.google.cycling.wheel_revolution.cumulative
دامنه‌های مجوز OAuth	https://www.googleapis.com/auth/fitness.location.read https://www.googleapis.com/auth/fitness.location.write
فیلدها (قالب — واحدها)	انقلاب‌ها ( int —تعداد) تعداد چرخش چرخ‌های دوچرخه.

اندروید

نام	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 متر بر ثانیه

اندروید

نام	com.google.distance.delta
شیء نوع داده	TYPE_DISTANCE_DELTA
مجوزهای اندروید	ACCESS_FINE_LOCATION و ACTIVITY_RECOGNITION
فیلدها (قالب — واحدها)	فاصله میدانی ( 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 —درجه) عرض جغرافیایی یک مکان بر حسب درجه. محدوده معتبر : ۹۰- تا ۹۰ درجه طول جغرافیایی ( float —درجه) طول جغرافیایی یک مکان بر حسب درجه. محدوده معتبر : -180 تا 180 درجه دقت ( float - متر) «شعاع دقت» تخمینی مکان، بر حسب متر خواهد بود. برای مثال، اگر دایره‌ای دور این مکان با شعاعی برابر با دقت رسم کنید، باید ۶۸٪ احتمال وجود داشته باشد که مکان واقعی کاربر درون دایره باشد. این تخمین فقط برای دقت افقی است. دقت جهت، سرعت یا ارتفاع (اگر این موارد برای این مکان لحاظ شده باشند) را نشان نمی‌دهد. اگر این مکان دقت افقی نداشته باشد، مقدار ۰.۰ برگردانده می‌شود. برد معتبر : 0 تا 10000 متر ارتفاع ( float - متر) ارتفاع محل از سطح دریا، بر حسب متر. برد معتبر : -100,000—100,000 متر

اندروید

نام	com.google.location.sample
شیء نوع داده	TYPE_LOCATION_SAMPLE
مجوز اندروید	ACCESS_FINE_LOCATION
فیلدها (قالب — واحدها)	FIELD_LATITUDE ( float —درجه) عرض جغرافیایی یک مکان بر حسب درجه. محدوده معتبر : ۹۰- تا ۹۰ درجه طول فیلد ( float —درجه) طول جغرافیایی یک مکان بر حسب درجه. محدوده معتبر : -180 تا 180 درجه FIELD_ACCURACY ( float — متر) «شعاع دقت» تخمینی مکان، بر حسب متر خواهد بود. برای مثال، اگر دایره‌ای دور این مکان با شعاعی برابر با دقت رسم کنید، باید ۶۸٪ احتمال وجود داشته باشد که مکان واقعی کاربر درون دایره باشد. این تخمین فقط برای دقت افقی است. دقت جهت، سرعت یا ارتفاع (اگر این موارد برای این مکان لحاظ شده باشند) را نشان نمی‌دهد. اگر این مکان دقت افقی نداشته باشد، مقدار ۰.۰ برگردانده می‌شود. برد معتبر : 0 تا 10000 متر 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 تا 11000 متر بر ثانیه

اندروید

نام	com.google.speed
شیء نوع داده	TYPE_SPEED
مجوز اندروید	ACCESS_FINE_LOCATION
فیلدها (قالب — واحدها)	سرعت ( float - متر بر ثانیه) سرعت سفر. محدوده معتبر : 0 تا 11000 متر بر ثانیه