تطوير تجارب الخطوات باستخدام Google Health API

تتتبّع واجهة برمجة التطبيقات Google Health API خطوات المستخدم وبيانات نشاطه باستخدام نوع بيانات الفاصل الزمني steps. يمثّل عدد الخطوات مقياسًا أساسيًا للنشاط البدني اليومي، ما يساعد المطوّرين في تتبُّع التقدّم في اللياقة البدنية وحساب استهلاك الطاقة وإنشاء ملخّصات يومية للنشاط تظهر للمستخدمين.

تعرَّف على كيفية قراءة مقاييس عدد الخطوات وتنظيمها في تطبيقك لتقديم أفضل تجربة للمستخدمين.

أنواع البيانات المتوافقة

تتيح واجهة برمجة التطبيقات نوع البيانات التالي لتتبُّع عدد الخطوات:

الجدول: أنواع بيانات الخطوات في واجهة برمجة التطبيقات Google Health API

نوع البيانات   dataType   مَعلمة filter	نوع السجلّ	العمليات المتاحة	النطاق	إمكانية استخدام إشعارات الويب	إمكانية استخدام الأصفار الحقيقية
الخطوات   steps   steps	الفاصل الزمني	list وreconcile وrollup وdailyRollup	.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 لتلقّي إشعارات في الوقت الفعلي عند استيراد بيانات خطوات جديدة أو مزامنتها. بدلاً من طلب نقاط نهاية REST، يمكنك تعديل لوحات البيانات من جهة العميل ديناميكيًا استجابةً لإشعارات الويب هذه. لمعرفة التفاصيل حول كيفية إعداد الاشتراكات، اطّلِع على إشعارات الويب.

التعامل مع الأصفار الحقيقية

تستخدم واجهة برمجة التطبيقات Google Health API الأصفار الحقيقية لحلّ الفواصل الزمنية التي لا يكون فيها المستخدم نشطًا. إذا كان المستخدم نشطًا أو يرتدي جهاز تتبُّع ولكنه لا يمشي، يسجّل جهاز التتبُّع فواصل زمنية صريحة للخطوات بقيمة count تساوي "0". يسمح لك ذلك بالتمييز بين الفترات التي لم يتخذ فيها المستخدم أي خطوات أثناء ارتداء الجهاز والفترات التي لم يكن يرتديه فيها على الإطلاق. يُرجى الرجوع إلى دليل توفّر البيانات والأصفار الحقيقية لمزيد من التفاصيل.