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