기기 카메라의 지리 공간 포즈를 가져옵니다.

Geospatial API를 사용하도록 앱 설정을 구성한 후에는 Earth.getCameraGeospatialPose()를 호출하여 최신 프레임에서 카메라의 지리정보 위치를 설명하는 GeospatialPose를 가져올 수 있습니다. Earth 객체에서 관리되는 이 포즈에는 다음 정보가 포함됩니다.

  • 위도 및 경도로 표현된 위치
  • 고도
  • EUS 좌표계에서 X+가 동쪽을, Y+가 위쪽을, Z+가 남쪽을 가리키는 사용자의 방향을 근사하는 방향입니다.

추적 상태 확인

지리적 값은 Earth.TrackingState이 TrackingState.TRACKING인 경우에만 유효합니다. 모든 Geospatial API 호출을 Earth.TrackingState 컨트롤 블록으로 래핑해야 합니다.

자바

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이 아닌 경우 Earth.TrackingState는 TrackingState.PAUSED 또는 TrackingState.STOPPED일 수 있습니다. 두 조건이 모두 false인 경우 Earth.Earthstate를 선택합니다. 그러면 Earth 객체가 추적되지 못하게 하는 다른 오류 상태가 표시됩니다.

정확하게 촬영할 수 있도록 포즈를 조정하세요.

기기가 기본 방향으로 세워져 있으면 AR 추적과의 자연스러운 정렬로 인해 피치 (X+) 및 롤 (Z+) 각도가 정확한 경향이 있습니다. 그러나 요 (Y+) 각도는 VPS 데이터 가용성과 위치의 시간 조건에 따라 달라질 수 있습니다. 앱에서 정확성을 위해 조정해야 할 수 있습니다.

GeospatialPose.getOrientationYawAccuracy()는 특정 GeospatialPose의 요 (Y+) 각도에 대한 정확도 추정치를 제공합니다. 방향 요 정확도는 GeospatialPose.getEastUpSouthQuaternion()에서 반환된 요 각도 주변의 68번째 백분위 신뢰 수준의 반경(도)을 나타내는 숫자입니다. 즉, GeospatialPose의 실제 요각이 정확할 확률은 68% 입니다.

값이 클수록 정확도가 낮습니다. 예를 들어 예상 요 각도가 60도이고 요 정확도가 10도인 경우 실제 요각이 50~70도일 확률이 68% 입니다.

다음 단계