API های اندروید

APIهای Google Fit برای Android بخشی از خدمات Google Play هستند. APIهای Google Fit در Android نسخه 4.1 (سطح API 16) و بالاتر پشتیبانی می‌شوند. با استفاده از این API ها، برنامه شما می تواند کارهای زیر را انجام دهد:

  • داده‌های تقریباً واقعی و تاریخی، از جمله داده‌های دستگاه‌های کم‌انرژی بلوتوث (BLE) را بخوانید.
  • ثبت فعالیت ها
  • داده ها را با یک جلسه مرتبط کنید.
  • اهداف تناسب اندام را تعیین کنید.

خواندن داده های حسگر

اگر برنامه شما اطلاعاتی درباره فعالیت کاربر، مانند گام‌های روزانه او ارائه می‌کند، نشان دادن داده‌های تقریباً واقعی در مورد حرکات کاربر می‌تواند مفید باشد. Sensors API دسترسی به جریان‌های داده خام را فراهم می‌کند که حاوی این اطلاعات است. داده‌ها می‌توانند از حسگرهای موجود در دستگاه مجهز به Android و همچنین از حسگرهای دستگاه‌های همراه، مانند پوشیدنی‌ها به دست آیند.

داده ها را ثبت کنید

اگر برنامه شما نیاز به جمع آوری، ذخیره و همگام سازی داده های مربوط به فعالیت فیزیکی کاربر دارد، می توانید از Recording API استفاده کنید. این API داده های سلامت و تندرستی را با استفاده از اشتراک ها ذخیره می کند. برنامه شما یک یا چند نوع فعالیت را برای ضبط مشخص می کند. سپس Google Fit داده‌های انواع مشخص‌شده را حتی زمانی که برنامه شما اجرا نمی‌شود در پس‌زمینه ذخیره می‌کند. همچنین با راه اندازی مجدد سیستم، این اشتراک ها را بازیابی می کند.

نمودار Google Fit
شکل 1. Google Fit در اندروید.

داده های تاریخی

اگر می‌خواهید کاربران بتوانند داده‌های تناسب اندام را از فعالیت‌های گذشته مشاهده کنند، می‌توانید از History API استفاده کنید. این API دسترسی به داده‌های سلامت و سلامتی را فراهم می‌کند و به برنامه‌ها اجازه می‌دهد عملیات‌های انبوه، مانند درج، حذف، و خواندن داده‌ها را انجام دهند.

جلسات

داده های تناسب اندام به خودی خود می توانند مفید باشند، اما داده ها زمانی مفیدتر هستند که آنها را با اطلاعات اضافی درباره فعالیت کاربر ترکیب کنید. Sessions API داده‌های سلامت و تندرستی را همراه با برخی فراداده‌ها در واحدهایی به نام Session دسته‌بندی می‌کند. جلسات بازه زمانی را نشان می دهد که در طی آن کاربر یک فعالیت تناسب اندام را انجام می دهد.

مشاهده و تعیین اهداف

برنامه شما می‌تواند با نشان دادن اینکه چگونه فعالیت تناسب اندام آنها با اهدافی که تعیین کرده‌اند مقایسه می‌کند، به انگیزه دادن به کاربران کمک کند. Goals API به برنامه شما کمک می کند تا اهداف سلامت و تناسب اندام را به کاربران نشان دهد.