بعد ضبط إعدادات تطبيقك لاستخدام واجهة برمجة التطبيقات Geospatial API، يمكنك طلب ArEarth_getCameraGeospatialPose
للحصول على ArGeospatialPose
توضّح تحديد الموقع الجغرافي للجهاز للكاميرا في أحدث إطار. يحتوي هذا الوضع الذي تتم إدارته في كائن ArEarth
على المعلومات التالية:
- الموقع الجغرافي، معبرًا عنه بخط العرض وخط الطول
- الارتفاع
- اتجاه تقريبي للاتجاه الذي يواجهه المستخدم في نظام إحداثي الاتحاد الأوروبي، مع توجيه +X نحو الشرق، وتوجيه +Y لأعلى، و+ Z تشير إلى الجنوب
التحقّق من حالة التتبّع
تكون القيم الجغرافية المكانية صالحة فقط عندما تكون قيمة ArEarth.ArTrackingState
هي ArTrackingState.AR_TRACKING_STATE_TRACKING
وArEarth.ArEarthState
هي AR_EARTH_STATE_ENABLED
. تأكَّد من إدراج جميع طلبات البيانات من واجهة برمجة التطبيقات الجغرافية المكانية في مجموعة تحكُّم ArEarth.ArTrackingState
.
if (ar_earth != NULL) { ArTrackingState earth_tracking_state = AR_TRACKING_STATE_STOPPED; ArTrackable_getTrackingState(ar_session, (ArTrackable*)ar_earth, &earth_tracking_state); if (earth_tracking_state == AR_TRACKING_STATE_TRACKING) { ArGeospatialPose* camera_geospatial_pose = NULL; ArGeospatialPose_create(ar_session, &camera_geospatial_pose); ArEarth_getCameraGeospatialPose(ar_session, ar_earth, camera_geospatial_pose); // camera_geospatial_pose contains geodetic location, rotation, and // confidences values. ArGeospatialPose_destroy(camera_geospatial_pose); } }
إذا لم تصبح ArEarth.ArTrackingState
ArTrackingState.AR_TRACKING_STATE_TRACKING
، قد تكون ArEarth.ArTrackingState
هي AR_TRACKING_STATE_PAUSED
أو AR_TRACKING_STATE_STOPPED
. إذا لم ينطبق أي من هذه الشروط، تحقّق من ArEarth.ArEarthState
التي تعرض حالات الخطأ الأخرى التي قد تمنع تتبُّع عنصر ArEarth
.
ضبط الوضعية للتأكد من دقتها
عندما يكون الجهاز في وضع مستقيم في الاتجاه التلقائي، غالبًا ما تكون زوايا درجة الصوت (+X) واللف (+Z) دقيقة بسبب المحاذاة الطبيعية مع تعقب الواقع المعزّز. ومع ذلك، يمكن أن تختلف زوايا الانحراف (Y+) اعتمادًا على توافر بيانات VPS والظروف الزمنية في الموقع. قد يحتاج تطبيقك إلى إجراء تعديلات لضمان الدقة.
تقدّم ArGeospatialPose_getOrientationYawAccuracy()
تقديرًا دقيقًا لزوايا الانحراف (Y+ ) لمعيار ArGeospatialPose
معيّن. ودقة الانحراف في الاتجاه هي رقم يصف نصف القطر، بالدرجات، لمستوى الثقة 68 بالمائة حول زوايا الانحراف الناتجة عن ArGeospatialPose_getEastUpSouthQuaternion()
. بمعنى آخر، هناك احتمال بنسبة% 68 أن تكون زاوية الانحراف الحقيقية لجهاز ArGeospatialPose
دقيقة.
تشير القيم الأكبر إلى دقة أقل. على سبيل المثال، إذا كانت زاوية الانحراف المقدَّرة هي 60 درجة ودقة الانحراف 10 درجات، فهناك احتمال 68% أن زاوية الانحراف الحقيقية تتراوح بين 50 و70 درجة.
الخطوات التالية
- ضع مرساة جيوفضائية من خلال الحصول على وضع المرساة الجيوفضائية.