डिवाइस के कैमरे की जियोस्पेशियल पोज़ पाएं

Geospatial API का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन की सेटिंग कॉन्फ़िगर करने के बाद, Earth.getCameraGeospatialPose() को कॉल करके GeospatialPose पाया जा सकता है. इससे, नए फ़्रेम में कैमरे के लिए, डिवाइस की जियोस्पेशल पोज़िशनिंग के बारे में पता चलता है. इस पोज़ को Earth ऑब्जेक्ट में मैनेज किया जाता है. इसमें यह जानकारी शामिल होती है:

  • जगह की जानकारी, अक्षांश और देशांतर में दी गई हो
  • ऊंचाई
  • ईयूएस कोऑर्डिनेट सिस्टम में उपयोगकर्ता की तरफ़ का ओरिएंटेशन

ट्रैकिंग स्टेटस की जांच करना

जियोस्पेशल वैल्यू सिर्फ़ तब मान्य होती हैं, जब Earth.TrackingState, TrackingState.TRACKING हो. पक्का करें कि सभी Geospatial API कॉल को 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+) ऐंगल सटीक होते हैं. हालांकि, VPS डेटा की उपलब्धता और किसी जगह के समय की स्थितियों के आधार पर यॉ (Y+) के कोण अलग-अलग हो सकते हैं. सटीक जानकारी पाने के लिए, आपके ऐप्लिकेशन में बदलाव करने पड़ सकते हैं.

GeospatialPose.getOrientationYawAccuracy() से, खास GeospatialPose के लिए यॉ (Y+) कोणों का सटीक अनुमान मिलता है. स्क्रीन की ओरिएंटेशन यॉ की सही जानकारी, GeospatialPose.getEastUpSouthQuaternion() से मिले यॉर ऐंगल के आस-पास के 68वें पर्सेंटाइल कॉन्फ़िडेंस लेवल के दायरे को दिखाती है. यह संख्या, डिग्री के हिसाब से होती है. दूसरे शब्दों में, इस बात की 68% संभावना है कि GeospatialPose का असल याव ऐंगल सटीक हो.

ज़्यादा वैल्यू का मतलब है कि अनुमान कम सटीक है. उदाहरण के लिए, अगर अनुमानित याव ऐंगल 60 डिग्री है और याव ऐंगल की सटीक वैल्यू 10 डिग्री है, तो इस बात की 68% संभावना है कि असल याव ऐंगल 50 से 70 डिग्री के बीच हो.

आगे क्या करना है