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

Geospatial API를 사용하도록 앱 설정을 구성한 후에는 기기 카메라의 AREarthManager.CameraGeospatialPose를 가져올 수 있습니다. AREarthManager 객체에서 관리되는 이 포즈에는 다음 정보가 포함됩니다.

  • 위도와 경도로 표시되는 위치
  • 고도
  • X+가 동쪽을 가리키고 Y+가 위쪽을 가리키며 Z+가 남쪽을 가리킴으로 사용자가 EUS 좌표계에서 향하는 방향과 가까운 방향

추적 상태 확인

지리정보 값은 AREarthManager.EarthTrackingState가 TrackingState.Tracking인 경우에만 유효합니다. 모든 Geospatial API 호출을 AREarthManager.EarthTrackingState 제어 블록에 래핑해야 합니다.

var earthTrackingState = EarthManager.EarthTrackingState;
if (earthTrackingState == TrackingState.Tracking)
{
  // camera_geospatial_pose contains geodetic location, rotation, and
  // confidences values.
  var cameraGeospatialPose = EarthManager.CameraGeospatialPose;
}

AREarthManager.EarthTrackingState가 TrackingState.Tracking가 되지 않으면 AREarthManager.EarthTrackingState는 TrackingState.Limited 또는 TrackingState.None일 수 있습니다. 두 조건이 모두 충족되지 않으면 TrackingState.EarthTrackingState를 확인합니다. 이 상태는 AREarthManager 객체가 추적하지 못하게 할 수 있는 다른 오류 상태를 표시합니다.

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

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

GeospatialPose.OrientationYawAccuracy는 특정 AREarthManager.CameraGeospatialPose의 요 (Y+) 각도에 관한 예상 정확도를 제공합니다. 방향 요 정확도는 GeospatialPose.EunRotation에서 요각 신뢰 수준의 68번째 백분위수 신뢰 수준의 반경을 도 단위로 설명하는 숫자입니다. 즉, AREarthManager.CameraGeospatialPose의 실제 요각이 다음과 같이 반환된 각도 내에서 정확할 확률은 68% 입니다. GeospatialPose.OrientationYawAccuracy

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

다음 단계