iOS 앱에 Geospatial API 사용 설정

Geospatial API를 사용할 수 있도록 앱 설정을 구성합니다.

기본 요건

기본 AR 개념을 이해합니다. ARCore 세션을 구성하는 방법을 알아보세요.

설명된 기능을 보여주는 샘플 앱을 실행하려는 경우 자세한 내용은 iOS용 ARCore 지리정보 빠른 시작

자세한 내용은 자세한 내용은 Geospatial API 소개를 참조하세요. Geospatial API에 대한 정보

ARCore로 개발하는 것이 처음인 경우 시작하기를 참고하세요. 소프트웨어 및 하드웨어 요구 사항, 기본 요건 및 기타 정보를 수집해야 합니다.

ARCore API 사용 설정

앱에서 VPS (Visual Positioning System)를 사용하려면 먼저 다음 작업을 완료해야 합니다. ARCore API를 사용 설정합니다. 새 Google Cloud 프로젝트에서 생성할 수 있습니다 이 서비스는 지리 공간 앵커를 호스팅, 저장, 확인

키 없는 승인을 사용하는 것이 좋지만 API 키 승인도 지원됩니다.

앱에 필수 라이브러리 추가

앱이 ARCore API를 호출하도록 승인한 후에는 앱에서 지리정보 기능 사용 설정

ARCore SDK 및 지원되는 iOS를 포함하도록 앱의 Podfile 업데이트 관리할 수 있습니다 방법은 다음과 같습니다.

  1. 다음 platform 및 pod를 프로젝트의 Podfile:

    platform :ios, '11.0'
pod 'ARCore/Geospatial', '~> 1.45.0'

    iOS 10을 지원하려면 platform :ios, '10.0'를 지정할 수도 있습니다. Geospatial API는 iOS 11 이상에서 런타임에만 작동합니다.

  2. 터미널 창을 열고 다음 폴더에서 pod install를 실행합니다. Xcode 프로젝트가 존재하는지 확인하세요.

    이렇게 하면 코드를 빌드하고 배포하는 데 사용하는 .xcworkspace 파일이 생성됩니다. 실행할 수 있습니다

개발 환경이 ARCore SDK 요구사항을 충족하는지 확인합니다. 빠른 시작에 설명되어 있습니다.

세션 구성에서 지리정보 기능 사용 설정

기기 호환성 확인

ARCore를 지원하는 모든 기기가 Geospatial API를 지원하는 것은 아닙니다. 빠른 시작에 설명되어 있습니다.

사용 GARSession.isGeospatialModeSupported: 드림 다음과 같이 기기를 확인합니다.

if (![self.garSession isGeospatialModeSupported:GARGeospatialModeEnabled]) {
  [self setErrorStatus:@"GARGeospatialModeEnabled is not supported on this device."];
  return;
}

GARSessionConfiguration *configuration = [[GARSessionConfiguration alloc] init];
configuration.geospatialMode = GARGeospatialModeEnabled;
[self.garSession setConfiguration:configuration error:&error];
if (error) {
  [self setErrorStatus:[NSString stringWithFormat:@"Failed to configure GARSession: %d",
                                                  (int)error.code]];
  return;
}

런타임 시 사용자에게 위치 정보 액세스 권한 요청

앱이 런타임 시 다음과 같은 위치 정보 액세스 권한을 요청해야 합니다. 다음과 같이 세션을 구성합니다.

기기의 현재 위치에서 Geospatial 사용 가능 여부 확인

Geospatial API는 VPS와 GPS의 조합을 사용하여 Geospatial 변환을 결정하므로 기기에서 위치를 확인할 수 있는 한 API를 사용할 수 있습니다. 실내 공간 및 밀집한 도시 환경과 같이 GPS 정확도가 낮은 지역에서는 API가 VPS 범위를 사용하여 높은 정확도의 변환을 생성합니다. 일반적인 조건에서 VPS는 위치 정확도는 약 5m, 회전 정확도는 5도입니다. GARSession.checkVPSAvailabilityAtCoordinate:completionHandler:를 사용하여 특정 위치에 VPS 적용 범위가 있는지 확인합니다.

Geospatial API는 VPS 범위가 없는 영역에서도 사용할 수 있습니다. 오버헤드 장애물이 거의 또는 전혀 없는 야외 환경에서는 GPS만으로도 높은 정확도로 변환을 생성하기에 충분할 수 있습니다.

다음 단계