Cihazın kamerasının Jeo-uzamsal pozunu alın

Uygulamanızın ayarlarını Coğrafi API'yi kullanacak şekilde yapılandırdıktan sonra, cihazın en son karedeki kamera için coğrafi konumunu açıklayan bir GeospatialPose almak üzere Earth.getCameraGeospatialPose() işlevini çağırabilirsiniz. Earth nesnesinde yönetilen bu poz, aşağıdaki bilgileri içerir:

  • Enlem ve boylamla ifade edilen konum
  • Rakım
  • X+ doğuyu, Y+ yukarıyı ve Z+ güneyi işaret edecek şekilde EUS koordinat sisteminde kullanıcının baktığı yönü yaklaşık olarak gösteren yön

İzleme durumunu kontrol etme

Coğrafi değerler yalnızca Earth.TrackingState TrackingState.TRACKING olduğunda geçerlidir. Tüm Coğrafi API çağrılarını bir Earth.TrackingState kontrol bloğuna sarmalayın.

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 olmazsa Earth.TrackingState TrackingState.PAUSED veya TrackingState.STOPPED olabilir. Bu koşulların hiçbiri geçerli değilse Earth nesnesinin izlenmesini engelleyebilecek diğer hata durumlarını gösteren Earth.Earthstate seçeneğini işaretleyin.

Pozu doğru olacak şekilde ayarlayın

Cihaz varsayılan yönde dik konumda olduğunda, AR izlemeyle doğal hizalama nedeniyle perde (X+) ve yuvarlama (Z+) açıları genellikle hassastır. Bununla birlikte, sapma (Y+) açıları VPS verilerinin kullanılabilirliği ve konumdaki zamansal koşullara bağlı olarak değişiklik gösterebilir. Uygulamanızda doğruluk için düzenlemeler yapmanız gerekebilir.

GeospatialPose.getOrientationYawAccuracy(), belirli bir GeospatialPose için yan kayma (Y+) açıları için doğruluk tahmini sağlar. Yön sapma doğruluğu, GeospatialPose.getEastUpSouthQuaternion() tarafından döndürülen sapma açıları etrafındaki 68. yüzdelik dilim güven düzeyinin yarıçapını (derece cinsinden) tanımlayan bir sayıdır. Diğer bir deyişle, GeospatialPose'ın gerçek yalpalama açısının doğru olma olasılığı %68'dir.

Daha büyük değerler daha düşük doğruluk anlamına gelir. Örneğin, tahmini sapma açısı 60 derece ve sapma doğruluğu 10 derece ise gerçek sapma açısının 50 ile 70 derece arasında olma olasılığı %68'dir.

Sırada ne var?