Sau khi định cấu hình chế độ cài đặt của ứng dụng để sử dụng API Không gian địa lý, bạn có thể gọi Earth.getCameraGeospatialPose()
để lấy GeospatialPose
mô tả vị trí Không gian địa lý của thiết bị cho camera trong khung hình mới nhất. Tư thế này (được quản lý trong một đối tượng Earth
) chứa các thông tin sau:
- Vị trí, được biểu thị bằng vĩ độ và kinh độ
- Cao độ
- Hướng gần đúng với hướng mà người dùng đang nhìn trong hệ toạ độ EUS với X+ trỏ về phía Đông, Y+ trỏ lên và Z+ trỏ về phía Nam
Kiểm tra trạng thái theo dõi
Giá trị không gian địa lý chỉ hợp lệ khi Earth.TrackingState
là TrackingState.TRACKING
. Hãy nhớ gói tất cả lệnh gọi API Không gian địa lý trong một khối kiểm soát 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. }
Nếu Earth.TrackingState
không trở thành TrackingState.TRACKING
, Earth.TrackingState
có thể là TrackingState.PAUSED
hoặc TrackingState.STOPPED
. Nếu không có điều kiện nào trong số này đúng, hãy kiểm tra Earth.Earthstate
để cho thấy các trạng thái lỗi khác có thể khiến đối tượng Earth
không theo dõi được.
Điều chỉnh tư thế cho chính xác
Khi thiết bị thẳng đứng theo hướng mặc định, các góc cao độ (X+) và góc xoay (Z+) có xu hướng chính xác do sự căn chỉnh tự nhiên với tính năng theo dõi thực tế tăng cường. Tuy nhiên, các góc yaw (Y+) có thể thay đổi tuỳ thuộc vào khả năng cung cấp dữ liệu của VPS và điều kiện tạm thời tại vị trí. Ứng dụng của bạn có thể phải điều chỉnh để đảm bảo tính chính xác.
GeospatialPose.getOrientationYawAccuracy()
cung cấp số liệu ước tính độ chính xác cho các góc yaw (Y+) cho một GeospatialPose
nhất định. Độ chính xác về góc ngáp theo hướng là một con số mô tả bán kính (tính theo độ) của mức độ tin cậy theo phân vị thứ 68 về góc ngáp được trả về từ GeospatialPose.getEastUpSouthQuaternion()
. Nói cách khác, có 68% khả năng góc ngáp thực sự của GeospatialPose
là chính xác.
Giá trị lớn hơn cho biết độ chính xác thấp hơn. Ví dụ: nếu góc yaw yaw ước tính là 60 độ và độ chính xác yaw là 10 độ, thì có 68% xác suất rằng góc yaw thực sự nằm trong khoảng từ 50 đến 70 độ.
Các bước tiếp theo
- Đặt neo không gian địa lý bằng cách lấy tư thế Không gian địa lý của neo.