الحصول على الوضع الجيوفضائي لكاميرا الجهاز

بعد ضبط إعدادات تطبيقك لاستخدام Geospatial API، يمكنك استدعاء Earth.getCameraGeospatialPose() للحصول على GeospatialPose يصف تحديد الموقع الجغرافي للجهاز للكاميرا في أحدث إطار. يحتوي وضع الجسم هذا، الذي تتم إدارته في عنصر Earth، على المعلومات التالية:

  • الموقع الجغرافي، معرَّفًا بخطوط الطول والعرض
  • الارتفاع
  • اتجاه تقريبي للاتجاه الذي يواجهه المستخدم في نظام إحداثيات EUS مع توجيه X+ نحو الشرق وY+ نحو الأعلى وZ+ نحو الجنوب

التحقّق من حالة التتبّع

تكون القيم الجغرافية المكانية صالحة فقط عندما تكون قيمة Earth.TrackingState هي TrackingState.TRACKING. احرص على تضمين جميع طلبات البيانات من واجهة برمجة التطبيقات Geospatial API في كتلة تحكّم Earth.TrackingState.

JavaKotlin
if (earth != null && earth.getTrackingState() == TrackingState.TRACKING) {
  GeospatialPose cameraGeospatialPose = earth.getCameraGeospatialPose();
  // cameraGeospatialPose contains geodetic location, rotation, and confidences values.
}
 
if (earth.trackingState == TrackingState.TRACKING) {
  val cameraGeospatialPose = earth.cameraGeospatialPose
  // cameraGeospatialPose contains geodetic location, rotation, and confidences values.
}

إذا لم يصبح Earth.TrackingState TrackingState.TRACKING، قد يكون Earth.TrackingState TrackingState.PAUSED أو TrackingState.STOPPED. إذا لم يكن أيّ من هذين الشرطَين صحيحًا، ضَع علامة في المربّع Earth.Earthstate الذي يعرض حالات خطأ أخرى قد تمنع تتبُّع عنصر Earth.

تعديل الوضع للحصول على دقة أكبر

عندما يكون الجهاز منتصبًا في الوضع التلقائي، تميل زاويتا الانحراف (X+) والدوران (Z+) إلى أن تكونا دقيقتَين بسبب المواءمة الطبيعية مع التتبّع بالواقع المعزّز. ومع ذلك، يمكن أن تختلف زوايا الانحراف (Y+) حسب مدى توفّر بيانات VPS والظروف الزمنية في الموقع الجغرافي. قد يحتاج تطبيقك إلى إجراء تعديلات لتحسين الدقة.

تقدّم GeospatialPose.getOrientationYawAccuracy() تقديرًا للدقة لزوايا الانحراف (Y+) GeospatialPose معيّنة. دقة انحراف الاتجاه هي رقم يصف نصف القطر، بالدرجات، لمستوى الثقة في الشريحة المئوية 68 حول زوايا الانحراف التي تم إرجاعها من GeospatialPose.getEastUpSouthQuaternion(). بعبارة أخرى، هناك احتمال بنسبة% 68 أن تكون زاوية الانحراف الفعلية لـ GeospatialPose دقيقة.

تشير القيم الأكبر إلى انخفاض الدقة. على سبيل المثال، إذا كانت زاوية الانحراف المقدَّرة 60 درجة ودقة الانحراف 10 درجات، تكون هناك احتمالية بنسبة% 68 أن تكون زاوية الانحراف الفعلية بين 50 و70 درجة.

الخطوات التالية