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

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

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

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

تكون القيم الجيوفضائية صالحة فقط عندما تكون قيمة Earth.TrackingState هي TrackingState.TRACKING. تأكَّد من إدراج جميع طلبات البيانات من واجهة برمجة التطبيقات الجغرافية المكانية في مجموعة تحكُّم Earth.TrackingState.

Java

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

Kotlin

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 درجة.

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

• ضع مرساة جيوفضائية من خلال الحصول على وضع المرساة الجيوفضائية.