Google Health API بااستفاده از نوع داده بازهای steps، دادههای فعالیت و گامهای کاربر را ردگیری میکند. تعداد قدمها نشاندهنده معیار اساسی فعالیت بدنی روزانه است و به توسعهدهندگان کمک میکند پیشرفت تناسب اندام را پیگیری کنند، مصرف انرژی را محاسبه کنند، و خلاصههای فعالیت روزانه سَمت کاربر بسازند.
با نحوه خواندن و ساختاردهی سنجههای تعداد قدمها در برنامهتان آشنا شوید تا بهترین تجربه را به کاربرانتان ارائه دهید.
انواع دادههای پشتیبانیشده
این API از نوع داده زیر برای ردیابی تعداد قدمها پشتیبانی میکند:
| نوع داده | عملیات دردسترس |
حوزه |
|---|---|---|
|
مراحل
dataType:
stepsfilter parameter: steps
نوع گزارش: فاصله زمانی
وضوح ذخیرهسازی: ۱ دقیقه
دستگاههای سازگار
|
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 را ببینید.