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

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

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

추적 상태 확인

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

정확성을 위해 자세 조정

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

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

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

다음 단계