Lấy tư thế Không gian địa lý của máy ảnh

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 điều khiển 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+) thườ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 yaw (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 độ 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 của độ lệch hướng là một con số mô tả bán kính (tính bằng độ) của mức độ tin cậy thứ 68 theo tỷ lệ phần trăm xung quanh các góc lệch hướng đượ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ị càng lớn thì độ chính xác càng thấp. 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