iOS용 지리정보 빠른 시작

이 ARCore Geospatial API 빠른 시작에서는 Geospatial API를 보여주는 샘플 앱을 Xcode에서 실행하는 방법을 보여줍니다.

Geospatial API를 사용하여 자체 앱을 개발하는 방법에 대한 가이드는 다음을 참조하세요. iOS용 지리정보 개발자 가이드

Geospatial API에 관한 자세한 내용은 ARCore Geospatial API 소개를 참고하세요.

ARCore로 개발하는 것이 처음이라면 시작하기를 참고하세요.

기본 요건

Xcode 버전 13.0 이상
Cocoapods 1.4.0 이상(Cocoapods를 사용하는 경우)
iOS 12.0 이상을 실행하는 ARKit 호환 Apple 기기(iOS 12.0 이상 배포 타겟 필요)

샘플 앱 설정

iOS용 ARCore SDK에 포함된 GeospatialExample 프로젝트는 Geospatial API를 호출하는 코드를 설명합니다.

Google Cloud Storage에 GitHub의 iOS용 ARCore SDK 샘플 앱 코드를 가져옵니다.
터미널 또는 Finder 창을 열고 SDK를 클론했거나 다운로드한 폴더로 이동합니다.
arcore-ios-sdk-master/Examples 폴더로 이동합니다.
예시 폴더를 열고 GeospatialExample 폴더를 선택합니다. 열기를 클릭합니다.

Google Cloud 프로젝트 설정

앱에서 VPS (Visual Positioning System)를 사용하려면 먼저 다음 작업을 완료해야 합니다. ARCore API를 사용 설정합니다. 새 Google Cloud 프로젝트에서 생성할 수 있습니다 Geospatial API는 키 없는 인증 및 API 키 승인 모두. 이 빠른 시작 가이드에서는 API를 사용합니다. Key 메서드입니다.

승인 설정하기

VPS에 Geospatial API 호출을 수행하려면 샘플 앱에 승인이 필요합니다. 제한되지 않은 API 키를 사용할 수 있습니다. 제한된 API 키를 사용하는 경우 다음 작업도 수행해야 합니다. API 키와 연결할 번들 ID를 제공합니다.

XCode의 GeospatialExample 샘플 앱에서 ViewController.m을 엽니다. 파일을 열고 your-api-key를 검색합니다.

GARSession에 API 키 추가: your-api-key (따옴표 유지) 위에 있는 이전 단계인 게재 횟수:

self.garSession = [GARSession sessionWithAPIKey:@"your-api-key"
                               bundleIdentifier:nil
                                          error:&error];

ARCore SDK 설정

GeospatialExample 앱은 Podfile ARCore SDK 및 iOS 버전이 필요합니다. 이러한 종속 항목을 설치하려면 터미널 창을 열고 Xcode 프로젝트가 있는 폴더에서 pod install를 실행합니다. 존재하지 않습니다.

이렇게 하면 나중에 애플리케이션을 빌드하고 실행하는 데 사용할 .xcworkspace 파일이 생성됩니다. 있습니다.

샘플 앱 빌드 및 실행

Xcode에서 GeospatialExample 작업공간 파일을 선택하고 서명 및 기능.
서명 자동 관리 체크박스를 선택합니다.
Team 입력란에 팀 이름을 입력합니다.

Xcode에서 기본 번들 식별자를 사용해 앱을 실행할 수도 있지만 GeospatialExample을 자체 스텁으로 사용하는 경우 변경해야 합니다. 살펴보겠습니다
기기를 연결하여 샘플 앱을 실행합니다.
.xcworkspace 파일에서 GeospatialExample 앱을 빌드하고 실행하여 기기에서 실행합니다.

빌드 오류를 방지하려면 .xcworkspace에서 빌드해야 합니다. 파일(.xcodeproj 파일 아님)입니다.

해당 콘텐츠를 설명하는 디버그 정보와 함께 카메라 뷰가 기기의 현재 지리정보 변환 주변 환경을 스캔할 때 VPS 위치 지정이 지원되는 지역에 있다면 이동하면서 위치 정확성 신뢰도 값이 변경될 수 있습니다.

ARCore가 기기의 위치와 방향을 확신하는 경우 지리정보 변환을 사용하여 현재 위치를 고정합니다.

VPS 정보를 사용할 수 없는 경우 위치 정확도가 너무 낮을 수 있습니다. 이 앱이 인터넷에 연결되어 있어야 하며 VPS가 위치를 알고 있어야 합니다. 최상의 결과를 얻으려면 낮에 실내가 아닌 실외에서 샘플 앱을 실행하세요.

또한 VPS를 지원하지 않는 지역에 있거나 GPS 신호가 지원되지 않는 경우에도 충분한 데이터를 수집하려면 신뢰할 수 있는 결과를 위해 앵커를 배치할 수 있습니다

기준치를 조정하려면 다음 단계를 따르세요.

Xcode에서 ViewController.m 파일을 열고 다음 섹션으로 이동합니다.

// Thresholds for 'good enough' accuracy. These can be tuned for the
// application. We use both 'low'
// and 'high' values here to avoid flickering state changes.
static const CLLocationAccuracy kHorizontalAccuracyLowThreshold = 10;
static const CLLocationAccuracy kHorizontalAccuracyHighThreshold = 20;
static const CLLocationDirectionAccuracy kHeadingAccuracyLowThreshold = 15;
static const CLLocationDirectionAccuracy kHeadingAccuracyHighThreshold = 25;

필요에 따라 이러한 값을 조정합니다. 값이 클수록 정확도가 낮아집니다.

정확도를 낮추면 앱이 앵커를 배치할 때 더 큰 위도를 배치할 수 있습니다. 자세한 내용은 변환 정확성을 위해 조정 를 참조하세요.

다음 단계

검토: iOS용 지리정보 개발자 가이드 Geospatial API로 빌드를 시작해 보세요.