Setelah mengonfigurasi setelan aplikasi untuk menggunakan Geospatial API, Anda dapat memperoleh AREarthManager.CameraGeospatialPose
kamera perangkat. Pose ini, yang dikelola dalam objek AREarthManager
, berisi informasi berikut:
- Lokasi, dinyatakan dalam lintang dan bujur
- Ketinggian
- Orientasi yang mendekati arah hadap pengguna dalam sistem koordinat EUS dengan X+ menunjuk ke timur, Y+ menunjuk ke atas, dan Z+ menunjuk ke selatan
Memeriksa status pelacakan
Nilai geospasial hanya valid jika AREarthManager.EarthTrackingState
adalah TrackingState.Tracking
. Pastikan untuk menggabungkan semua panggilan Geospatial API dalam blok kontrol AREarthManager.EarthTrackingState
.
var earthTrackingState = EarthManager.EarthTrackingState;
if (earthTrackingState == TrackingState.Tracking)
{
// camera_geospatial_pose contains geodetic location, rotation, and
// confidences values.
var cameraGeospatialPose = EarthManager.CameraGeospatialPose;
}
Jika AREarthManager.EarthTrackingState
tidak menjadi TrackingState.Tracking
, AREarthManager.EarthTrackingState
mungkin adalah TrackingState.Limited
atau TrackingState.None
. Jika tidak satu pun kondisi ini benar, periksa TrackingState.EarthTrackingState
, yang menunjukkan status error lain yang mungkin mencegah objek AREarthManager
melacak.
Sesuaikan pose agar akurat
Saat perangkat tegak lurus dalam orientasi default, sudut pitch (X+) dan roll (Z+) cenderung akurat karena penyelarasan alami dengan pelacakan AR. Namun, sudut yaw (Y+) dapat bervariasi tergantung pada ketersediaan data VPS dan kondisi temporal di lokasi. Aplikasi Anda mungkin harus melakukan penyesuaian untuk akurasi.
GeospatialPose.OrientationYawAccuracy
memberikan perkiraan akurasi untuk sudut yaw (Y+) untuk AREarthManager.CameraGeospatialPose
tertentu. Akurasi yaw orientasi adalah angka yang menjelaskan radius, dalam derajat, tingkat keyakinan persentil ke-68 di sekitar sudut yaw pada GeospatialPose.EunRotation
. Dengan kata lain, ada 68% kemungkinan bahwa sudut yaw sebenarnya AREarthManager.CameraGeospatialPose
akurat dalam jumlah derajat yang ditampilkan oleh
GeospatialPose.OrientationYawAccuracy
.
Nilai yang lebih besar menunjukkan akurasi yang lebih rendah. Misalnya, jika perkiraan sudut yaw adalah 60 derajat dan akurasi yaw adalah 10 derajat, maka ada probabilitas 68% bahwa sudut yaw yang sebenarnya adalah antara 50 dan 70 derajat.
Langkah berikutnya
- Tempatkan anchor Geospasial dengan mendapatkan pose Geospasial anchor.