برای اطمینان از دقت دادهها و تجمیعهای مداوم، API گوگل هلث نحوه گزارش فعالیت کاربر را مدرن میکند. با معرفی true zeros و on-wrist filtering ، این API به شما امکان میدهد بین دورههایی که کاربر ثابت بوده و زمانی که دستگاه خود را نبسته است، به طور دقیق تمایز قائل شوید.
صفرهای واقعی
صفر واقعی یک نقطه داده صریح است که نشان میدهد کاربر دستگاه خود را پوشیده و به طور فعال ردیابی میکرده، اما برای یک معیار خاص مقدار صفر را ثبت کرده است. به عنوان مثال، یک کاربر ممکن است در یک بازه ۱ دقیقهای هنگام پوشیدن دستگاه خود، ۰ قدم یا ۰ مسافت را ثبت کند.
از نظر تاریخی، دادههای از دست رفته مبهم بودند. این دادهها میتوانستند نشان دهندهی این باشند که کاربر بیتحرک بوده یا دستگاه از مچ دست خارج شده است. API این مشکل را با ذخیره و بازگرداندن مقدار ۰ به طور صریح در زمانی که دستگاه پوشیده شده اما غیرفعال است، حل میکند. این تضمین میکند که شما میتوانید به وضوح بین دورههای ثابت روی مچ دست و دادههای از دست رفته تمایز قائل شوید.
فیلترینگ روی مچ دست
فیلترینگ روی مچ دست فرآیندی است که طی آن مشخص میشود آیا کاربر دستگاه خود را به صورت فیزیکی پوشیده است یا خیر. این امر به API اجازه میدهد تا دادههای نامربوط، مانند گامهای «فانتوم» ثبت شده به دلیل ارتعاشات وسیله نقلیه در حالی که دستگاه در کیف است را فیلتر کند.
انواع داده پشتیبانی شده
انواع دادههای زیر از رفتار صفر واقعی و فیلترینگ روی مچ دست پشتیبانی میکنند:
- ارتفاع
- فاصله
- طبقات
- مراحل
- کل کالری
تأثیر بر درخواست شما
پیادهسازی صفرهای واقعی، دقت تفسیر شکاف دادهها و محاسبات معیارها، مانند میانگینهای روزانه، را بهبود میبخشد.
رفتار لیست و جمعبندی
به طور پیشفرض، API گوگل هلث فقط دادههای روی مچ دست را برای انواع دادههای زیر برمیگرداند:
- عملیات لیست: نقاط داده را فقط برای دورههایی که دستگاه پوشیده شده است، برمیگرداند. فاصلههای خالی در لیست نشان میدهد که دستگاه از مچ دست خارج شده یا همگامسازی نشده است.
- عملیات جمعبندی: صفر در پاسخ، نشاندهنده صفر واقعی است (کاربر دستگاه را پوشیده اما حرکت نکرده است). اگر دستگاه ردیابی در یک بازه زمانی خاص استفاده نشده باشد، API هیچ دادهای برای آن پنجره جمعبندی برنمیگرداند.
مقایسه با API وب Fitbit
رابط برنامهنویسی کاربردی وب فیتبیت اغلب دادهها، از جمله صفرها، را حتی زمانی که دستگاه ردیابی استفاده نمیشد، برمیگرداند. رابط برنامهنویسی کاربردی گوگل هلث نمایش دقیقتری از حرکت ارائه میدهد.
| ویژگی | رابط برنامهنویسی کاربردی وب فیتبیت | رابط برنامهنویسی کاربردی گوگل هلث |
|---|---|---|
| ابهام عدم فعالیت | دادههای از دست رفته میتواند به معنای عدم فعالیت یا از کار افتادن مچ دست باشد. | صفرهای واقعی به صراحت عدم فعالیت در حین پوشیدن را نشان میدهند. |
| شکافهای دادهای | شکافهای داده میتوانند به طور پیشفرض روی جبرانهای UTC تنظیم شوند. | ذخیرهسازی صریح، مشکلات مربوط به منطقه زمانی و زمان شهری را حل میکند. |
| فیلتر کردن | فیلترینگ محدود روی مچ دست. | فیلترینگ دقیق روی مچ دست، دقت فیزیولوژیکی را تضمین میکند. |