Geospatial API는 VPS 및 GPS 데이터의 조합을 사용하여 매우 정확한 지리정보 변환을 생성합니다. API는 기기가 위치를 확인할 수 있는 모든 위치에서 사용할 수 있습니다.
- 실내 공간 및 밀집한 도시 환경과 같이 GPS 정확도가 낮은 지역에서는 API가 VPS 범위를 사용하여 높은 정확성으로 변환을 생성합니다.
- 오버헤드 장애물이 거의 또는 전혀 없는 야외 환경에서는 Geospatial API가 사용 가능한 GPS 위치 데이터를 사용하여 높은 정확도로 지리정보 변환을 생성할 수 있습니다.
AR 세션이 시작되기 전에 지정된 가로 위치에서 VPS 사용 가능 여부를 확인하고 이를 사용하여 더 구체적인 환경을 만들 수 있습니다(예: 'AR 시작' 표시). 버튼을 클릭합니다.
ARCore API 사용 설정
VPS 사용 가능 여부를 확인하려면 앱에서 ARCore API를 사용 설정해야 합니다.
앱에서 VPS 사용 가능 여부 확인
Geospatial API는 기기가 위치를 확인할 수 있는 모든 위치에서 사용할 수 있습니다. AR 환경이 VPS 범위에 따라 달라지는 경우 GARSession#checkVPSAvailabilityAtCoordinate:completionHandler:
를 사용하여 지정된 가로 위치에서 VPS 사용 가능 여부를 확인하는 비동기 작업인 GARVPSAvailabilityFuture
를 가져올 수 있습니다.
GARVPSAvailabilityFuture
를 가져온 후에는 폴링 또는 콜백을 통해 결과를 가져올 수 있습니다.
결과 설문조사
GARFuture.state
를 사용하여 Future
의 상태를 가져옵니다. 다음과 같은 세 가지 상태가 있습니다.
GARFutureStatePending
: 작업이 아직 완료되지 않았으므로 알려진 결과가 없습니다.GARFutureStateCancelled
:GARFuture#cancel
에 의해 작업이 취소되었습니다. 등록된 콜백은 호출되지 않습니다.GARFutureStateDone
: 작업이 완료됩니다.GARVPSAvailabilityFuture.result
를 사용하여 결과를 가져옵니다.
작업이 완료될 때까지 GARFuture.state
를 계속 확인할 수 있습니다.
콜백을 통해 결과 가져오기
콜백을 통해 Future
의 결과를 가져올 수도 있습니다. GARSession#checkVPSAvailabilityAtCoordinate:completionHandler:
를 사용하고 completionHandler
을 제공합니다. 이 completionHandler
는 Future
의 상태가 GARFutureStateDone
가 된 직후 기본 스레드에서 호출됩니다.
Future
취소
GARFuture#cancel
를 사용하여 Future
취소를 시도합니다. 스레드 동시 로드로 인해 취소 시도가 실제로 성공하지 못할 수도 있습니다.
GARFuture#cancel
는 이 시도에 성공하면 YES
를 반환하고 성공하지 못하면 NO
를 반환합니다.
VPS 범위 없이 Geospatial API 사용
Geospatial API는 VPS 범위가 없는 영역에서도 사용할 수 있습니다. 오버헤드 장애물이 거의 또는 전혀 없는 야외 환경에서는 GPS만 사용해도 높은 정확도로 자세를 취할 수 있습니다.
다음 단계
- 기기 카메라의 지리 공간 포즈를 가져와 실제 사용자 기기의 정확한 위치를 확인합니다.