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 máy ảnh trong khung hình mới nhất. Tư thế này, được quản lý trong đối tượng Earth
, chứa các thông tin sau:
- Vị trí, được thể hiện bằng vĩ độ và kinh độ
- Cao độ
- Hướng gần đúng với hướng người dùng đang đối mặt trong hệ toạ độ EUS, trong đó X+ chỉ về hướng đông, Y+ chỉ lên trên và Z+ chỉ về hướng 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
, thì 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 là đúng, hãy kiểm tra Earth.Earthstate
. Thành phần này 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ế để đảm bảo tính chính xác
Khi thiết bị đứng thẳng theo hướng mặc định, các góc độ nghiêng (X+) và nghiêng (Z+) có xu hướng chính xác do được căn chỉnh tự nhiên với tính năng theo dõi AR. Tuy nhiên, các góc xoay ngang (Y+) có thể thay đổi tuỳ thuộc vào tình trạng sẵn có của dữ liệu VPS và điều kiện thời gian 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 thông tin ước tính về độ 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 xoay thực 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 nghiêng ước tính là 60 độ và độ chính xác của góc nghiêng là 10 độ, thì có 68% khả năng góc nghiêng thực tế nằm trong khoảng từ 50 đến 70 độ.
Bước tiếp theo
- Đặt đinh neo Không gian địa lý bằng cách lấy tư thế Không gian địa lý của neo.