توسعه تجربیات مراحل با API گوگل هلث

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

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

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

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

جدول: انواع داده‌های مراحل API سلامت گوگل

نوع داده dataType پارامتر filter	رکورد نوع	موجود است عملیات	محدوده	وب‌هوک پشتیبانی	صفرهای واقعی پشتیبانی
مراحل steps steps	فاصله	فهرست کردن، تطبیق دادن، جمع کردن، جمع کردن روزانه	.activity_and_fitness.readonly .activity_and_fitness.writeonly

بخش‌های زیر جزئیات فنی مربوط به نوع داده‌ی steps ، از جمله مثال‌های نمایش REST و دستورالعمل‌های یکپارچه‌سازی را ارائه می‌دهند.

دامنه‌های مورد نیاز

برای دسترسی به این نوع داده، برنامه شما باید دامنه‌های OAuth زیر را درخواست کند:

• بخوانید : https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly
• بنویسید : https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly

دستورالعمل‌ها

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

مرور روزانه

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

ترسیم رابط‌های کاربری (آشتی‌سازی)

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

ردیابی و هیستوگرام‌های درون‌روزی

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

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

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

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

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

مدیریت صفرهای واقعی

رابط برنامه‌نویسی کاربردی گوگل هلث (Google Health API) برای حل فواصل زمانی بی‌تحرکی، صفرهای واقعی را پیاده‌سازی می‌کند. اگر کاربری فعال باشد یا ردیاب داشته باشد اما راه نرود، ردیاب فواصل زمانی گام‌ها را با count "0" به طور صریح می‌نویسد. این به شما امکان می‌دهد بین دوره‌هایی که کاربر هنگام پوشیدن دستگاه، صفر گام برداشته است و زمانی که اصلاً دستگاه را نپوشیده است، تمایز قائل شوید. برای جزئیات بیشتر به راهنمای حضور داده‌ها و صفرهای واقعی مراجعه کنید.