لضمان دقة البيانات وعمليات التجميع المتسقة، تعمل واجهة برمجة التطبيقات Google Health API على تحديث طريقة تسجيل نشاط المستخدم. من خلال تقديم true zeros وon-wrist filtering، تتيح لك واجهة برمجة التطبيقات التمييز بدقة بين الفترات التي كان فيها المستخدم ثابتًا والفترات التي لم يكن فيها يرتدي الجهاز.
True Zeros
القيمة الصفرية الحقيقية هي نقطة بيانات صريحة تشير إلى أنّ المستخدم كان يرتدي الجهاز ويتتبّع البيانات بشكل نشط، ولكن تم تسجيل قيمة صفرية لمقياس معيّن. على سبيل المثال، قد يسجّل المستخدم 0 خطوة أو 0 مسافة خلال فاصل زمني مدته دقيقة واحدة أثناء ارتداء الجهاز.
في السابق، كانت البيانات المفقودة غامضة. وقد يشير ذلك إلى أنّ المستخدم كان غير نشط أو أنّ الجهاز لم يكن على معصمه. وتحلّ واجهة برمجة التطبيقات هذه المشكلة من خلال تخزين القيمة 0 وعرضها بشكل صريح عندما يكون الجهاز مرتديًا ولكن غير نشط. يضمن ذلك إمكانية التمييز بوضوح بين الفترات التي تكون فيها الساعة ثابتة على المعصم والبيانات الناقصة.
الفلترة على المعصم
التصفية أثناء ارتداء الجهاز هي عملية تحديد ما إذا كان المستخدم يرتدي الجهاز فعليًا. يتيح ذلك لواجهة برمجة التطبيقات فلترة البيانات غير الضرورية، مثل الخطوات "الوهمية" المسجّلة بسبب اهتزازات المركبة أثناء وضع الجهاز في حقيبة.
أنواع البيانات المتوافقة
تتيح أنواع البيانات التالية سلوك القيمة الصفرية الحقيقية والفلترة على المعصم:
- الارتفاع
- المسافة
- الطوابق
- الخطوات
- إجمالي السعرات الحرارية
تأثير التغيير على تطبيقك
يؤدي تنفيذ القيم الصفرية الحقيقية إلى تحسين دقة تفسير فجوات البيانات واحتساب المقاييس، مثل المتوسطات اليومية.
سلوك القائمة والبيانات المجمّعة
بشكلٍ تلقائي، تعرض Google Health API البيانات التي يتم جمعها من الأجهزة القابلة للارتداء فقط لأنواع البيانات التالية:
- عمليات القائمة: تعرض نقاط البيانات فقط للفترات التي تم فيها ارتداء الجهاز.
- فجوات البيانات: تشير الفجوات والسجلات الناقصة في القائمة إلى أنّ الجهاز لم يكن على المعصم أو لم تتم مزامنته.
- السجلات الفارغة: يتم عرض نقاط البيانات التي كان المستخدم يرتدي فيها الجهاز ولكن لم يسجّل أي نشاط (أي صفر حقيقي) مع معلومات
dataSourceالعادية والفاصل الزمني أو الطابع الزمني، ولكن يتم حذف الحقل الخاص بالمقياس (مثل السمةcount). ويجب تفسيرها على أنّها قيم صفرية.
- عمليات التجميع: يشير الرقم صفر في الردّ إلى صفر حقيقي (كان المستخدم يرتدي الجهاز ولكنّه لم يتحرّك). إذا لم يكن جهاز التتبُّع موضوعًا على الجسم خلال فترة زمنية معيّنة، لن تعرض واجهة برمجة التطبيقات أي بيانات لفترة التجميع هذه.
في عمليات list، يمكن أن تؤدي عمليات المزامنة المتتالية للأجهزة المتصلة أيضًا إلى حدوث فواصل زمنية متداخلة عندما تعيد الخوارزميات على الجهاز فقط تقسيم بيانات قياس الاستخدام الأولية من أجهزة الاستشعار. لمزيد من المعلومات حول التعامل مع التداخلات في الفواصل الزمنية، يُرجى الاطّلاع على دليل إدارة البيانات.
مقارنة مع Fitbit Web API
كانت واجهة Fitbit Web API تعرض غالبًا بيانات، بما في ذلك أصفار، حتى عندما لا يتم ارتداء جهاز تتبُّع. توفّر Google Health API تمثيلاً أكثر دقة للحركة.
| الميزة | Fitbit Web API | Google Health API |
|---|---|---|
| غموض عدم النشاط | قد يشير عدم توفّر البيانات إلى عدم النشاط أو عدم ارتداء الساعة. | تشير القيم الصفرية الحقيقية بوضوح إلى عدم النشاط أثناء ارتداء الجهاز. |
| فجوات البيانات | يمكن ضبط فجوات البيانات تلقائيًا على إزاحات التوقيت العالمي المتفق عليه (UTC). | يحلّ التخزين الواضح المشاكل المتعلّقة بالمنطقة الزمنية والوقت المدني. |
| الفلترة | توفُّر خيارات فلترة محدودة على الساعة | يضمن الفلتر الصارم الذي يتم تطبيقه على المعصم دقة القياسات الفسيولوجية. |