توسعه تجربه‌های مربوط به تعداد قدم‌ها با Google Health API

‫Google Health API بااستفاده از نوع داده بازه‌ای steps، داده‌های فعالیت و گام‌های کاربر را ردگیری می‌کند. تعداد قدم‌ها نشان‌دهنده معیار اساسی فعالیت بدنی روزانه است و به توسعه‌دهندگان کمک می‌کند پیشرفت تناسب اندام را پیگیری کنند، مصرف انرژی را محاسبه کنند، و خلاصه‌های فعالیت روزانه سمت کاربر بسازند.

با نحوه خواندن و ساختاردهی سنجه‌های تعداد قدم‌ها در برنامه‌تان آشنا شوید تا بهترین تجربه را به کاربرانتان ارائه دهید.

انواع داده‌های پشتیبانی‌شده

این میانای برنامه‌سازی کاربردی از نوع داده زیر برای ردیابی تعداد قدم‌ها پشتیبانی می‌کند:

جدول: انواع داده‌های Google Health API Steps

نوع داده	عملیات دردسترس	حوزه
مراحل dataType: steps filter parameter: steps نوع گزارش: فاصله زمانی وضوح ذخیره‌سازی: ۱ دقیقه پشتیبانی از وب‌قلاب پشتیبانی از True zeros راهنمای گام‌به‌گام دستگاه‌های سازگار Fitbit Air Fitbit Alta Fitbit Alta HR Fitbit Blaze Fitbit Charge 2 Fitbit Charge 3 Fitbit Charge 4 Fitbit Charge 5 Fitbit Charge 6 Fitbit Flex 2 Fitbit Inspire Fitbit Inspire 2 Fitbit Inspire 3 Fitbit Inspire HR Fitbit Ionic Fitbit Luxe Fitbit MobileTrack Pixel Watch Pixel Watch 2 Pixel Watch 3 Pixel Watch 4 Fitbit Sense Fitbit Sense 2 Fitbit Versa Fitbit Versa 2 Fitbit Versa 3 Fitbit Versa 4 Fitbit Versa Lite	list, reconcile, rollup, dailyRollup	.activity_and_fitness.readonly .activity_and_fitness.writeonly

رهنمودها

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

محاسبه سرعت و گام

‫Google Health API از فرمول‌های استاندارد برای محاسبه سرعت و سرعت قدم‌ها استفاده می‌کند:

• سرعت = distance / time(hour)
• سرعت = time(seconds) / distance

سرصفحه Accept-Language مشخص‌شده در درخواست، واحد فاصله را تعیین می‌کند.

نمای کلی روزانه

برای تجمیع دقیق تعداد قدم‌های روزانه درطول سفر، تغییرات منطقه زمانی، یا ساعت تابستانی، محاسبات مدت‌زمان را در سمت کارخواه انجام ندهید. درعوض، نقطه پایانی dailyRollUp را پرسمان کنید که به‌طور خودکار بااستفاده از اختلاف ساعت UTC، شکاف‌های داده‌های فیزیکی را تطبیق می‌دهد. خلاصه StepsRollupValue را برمی‌گرداند که حاوی فیلد countSum است و نشان‌دهنده مجموع گام‌های انباشته‌شده برای روز درخواست‌شده است. برای جزئیات، تجمیع در روزهای تقویم را در راهنمای «تجمیع داده‌ها» ببینید.

طراحی میانای کاربر (تطبیق)

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

برای کسب اطلاعات درباره مدیریت فاصله‌های زمانی هم‌پوشان از همگام‌سازی‌های دستگاه متصل و تغییرپذیری مُهر زمان، به راهنمای مدیریت داده مراجعه کنید.

ردگیری درون‌روزی و بافت‌نگاشت‌ها

برای نمایش فعالیت دقیق کاربر درطول روز (مانند نمودارها و گراف‌ها):

• هیستوگرام‌های گام ساعتی یا دقیقه‌ای: نقطه پایان rollUp را پُرسمان کنید، مدت‌زمان را (مثلاً 60s برای ۱ دقیقه یا 3600s برای ۱ ساعت) بااستفاده از پارامتر windowSize مشخص کنید. چون داده‌های تعداد قدم در فواصل ۱ دقیقه‌ای (60s) ثبت می‌شود، windowSize را حداقل روی 60s تنظیم کنید. درخواست‌هایی که اندازه پنجره آن‌ها کمتر از یک دقیقه است (مثل 10s یا 30s) مجموع دقیقه‌ای را تقسیم نمی‌کنند و کل تعداد دقیقه را در اولین زیرمجموعه مطابق قرار می‌دهند. برای جزئیات، به پنجره تجمیع و وضوح فضای ذخیره‌سازی مراجعه کنید.
• همه سوابق گام: از نقطه پایانی list برای واکشی دقیق‌ترین سوابق گام خام استفاده کنید.

پایانه‌های rollUp،‏ dailyRollUp، و reconcile پارامتر dataSourceFamily را می‌پذیرند که به شما امکان می‌دهد داده‌ها را از گروه‌های منبع خاص فیلتر کنید. برای جزئیات بیشتر و نمونه‌های استفاده، به بخش فیلتر کردن براساس خانواده منبع داده در راهنمای «فیلتر کردن داده‌ها» مراجعه کنید.

همگام‌سازی هم‌زمان بااستفاده از وب‌قلاب‌ها

در مجموعه نوع داده steps مشترک شوید تا وقتی داده‌های جدید گام وارد یا همگام‌سازی می‌شود، به‌طور هم‌زمان مطلع شوید. به‌جای نظرسنجی از نقاط پایانی REST، داشبوردهای سمت کارخواه را به‌طور پویا در پاسخ به این اعلان‌های وب‌هوک به‌روز کنید. برای جزئیات مربوط به نحوه راه‌اندازی اشتراک‌ها، اشتراک‌های Webhook را ببینید.