Geospatial API는 VPS와 GPS 데이터를 조합하여 고정밀 지리적 위치 포즈를 생성합니다. API는 기기가 위치를 확인할 수 있는 모든 위치에서 사용할 수 있습니다.
- 실내 공간 및 인구 밀집 도시 환경과 같이 GPS 정확도가 낮은 지역에서는 API가 VPS 노출 영역을 기반으로 고정밀도 포즈를 생성합니다.
- 오버헤드 장애물이 거의 또는 전혀 없는 야외 환경에서는 Geospatial API가 사용 가능한 GPS 위치 데이터를 사용하여 높은 정확도로 지리정보 포즈를 생성할 수 있습니다.
AR 세션이 시작되기 전에 지정된 가로 위치에서 VPS 사용 가능 여부를 확인하고 이를 사용하여 더 구체적인 환경을 만들 수 있습니다(예: VPS를 사용할 수 있을 때만 'AR 들어가기' 버튼을 표시하는 경우).
ARCore API 사용 설정
앱에서 VPS 가용성을 확인하려면 ARCore API를 사용 설정해야 합니다.
앱에서 VPS 사용 가능 여부 확인
Geospatial API는 기기가 위치를 파악할 수 있는 모든 장소에서 사용할 수 있습니다. AR 환경이 VPS 적용 범위에 좌우되는 경우 AREarthManager.CheckVpsAvailabilityAsync()
를 사용하여 지정된 가로 위치에서 VPS 가용성을 확인하는 비동기 작업인 VpsAvailabilityPromise
를 가져올 수 있습니다.
VpsAvailabilityPromise
가 있으면 폴링하여 결과를 얻을 수 있습니다.
결과 설문조사
VpsAvailabilityPromise.State
을 사용하여 InterruptiblePromise
의 상태를 가져옵니다. 상태는 세 가지가 있습니다.
Pending
: 작업이 아직 완료되지 않았으므로 결과를 알 수 없습니다.Cancelled
:VpsAvailabilityPromise.Cancel()
에서 작업을 취소했습니다. 등록된 콜백은 호출되지 않습니다.Done
: 작업이 완료되었습니다.VpsAvailabilityPromise.Result
를 사용하여 결과를 가져옵니다.
작업이 완료될 때까지 VpsAvailabilityPromise.State
을(를) 계속 확인할 수 있습니다.
InterruptiblePromise
취소
VpsAvailabilityPromise.Cancel()
를 사용하여 InterruptiblePromise
취소를 시도합니다. 스레드 병렬로 인해 취소 시도가 실제로 성공하지 못할 수 있습니다.
VPS 적용 범위 외 지역에서 Geospatial API 사용
Geospatial API는 VPS 적용 범위가 없는 지역에서도 사용할 수 있습니다. 상단에 장애물이 거의 없거나 없는 야외 환경에서는 GPS만으로도 높은 정확도로 포즈를 생성할 수 있습니다.
다음 단계
- 기기 카메라의 Geospatial pose를 가져와 실제 세계에서 사용자 기기의 정확한 위치를 확인합니다.