Android용 지리정보 빠른 시작

ARCore Geospatial API 빠른 시작에서는 Android 스튜디오에서 Geospatial API를 보여주는 샘플 앱을 실행하는 방법을 보여줍니다.

Geospatial API를 사용하여 자체 앱을 개발하는 방법은 Android용 지리정보 개발자 가이드 (Kotlin/자바) 또는 Android NDK (C)용 지리정보 개발자 가이드를 참고하세요.

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

ARCore를 사용한 개발이 처음인 경우 시작하기를 참고하세요.

요구사항

기기 지원

ARCore에서 작동하도록 인증된 기기의 전체 목록은 지원되는 기기를 참고하세요. Geospatial API의 경우 필수 하드웨어 중 하나는 지리 공간 API 사양을 충족하는 자기계입니다. 일부 자기계가 사양을 충족하지 않습니다. 이러한 범위를 벗어난 자기계가 있는 기기는 지원되지 않습니다.

소프트웨어

  • 지원되는 기기에 설치된 최신 버전의 Google Play AR 서비스

  • Android SDK 플랫폼 버전 7.0 (API 수준 24) 이상을 사용하는 Android 스튜디오 버전 3.0 이상

  • Android용 ARCore SDK는 다음 두 가지 방법 중 하나로 사용할 수 있습니다.

    • GitHub에서 다운로드하여 머신에서 추출합니다.

    • 다음 명령어를 사용하여 저장소를 클론합니다.

      git clone https://github.com/google-ar/arcore-android-sdk.git

샘플 앱 열기 및 설정

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

  1. Android 스튜디오의 File 메뉴에서 Open을 클릭합니다.

  2. arcore-android-sdk의 프로젝트 폴더로 이동합니다.

  3. samples 폴더를 열고 geospatial_java 폴더를 선택한 후 열기를 클릭합니다.

Google Cloud 프로젝트 설정

시각적 포지셔닝 시스템 (VPS)을 사용하려면 앱을 ARCore API에 사용 설정된 Google Cloud 프로젝트와 연결해야 합니다.

Google Cloud 프로젝트에서 ARCore API를 사용 설정해야 합니다. 프로젝트를 만들어야 하는 경우 다음 단계를 따르세요.

  1. Google Cloud Platform에서 프로젝트 만들기로 이동합니다.

  2. 적절한 프로젝트 이름을 입력하고 위치를 선택합니다.

  3. 만들기를 클릭합니다.

  4. 사이드바에서 API 및 서비스를 선택한 다음 라이브러리를 선택합니다.

  5. ARCore API를 검색하여 선택하고 사용 설정을 클릭합니다.

승인 설정하기

VPS에 지리정보 API를 호출하기 위해 샘플 앱 인스턴스에서 키 없는 승인을 사용할 수 있습니다.

  1. Android 스튜디오 프로젝트에서 Gradle 도구창을 엽니다.

  2. <project-name> > work > Tasks > android로 이동합니다.

  3. signingReport 태스크를 실행합니다.

  4. SHA-1 디지털 지문을 복사하여 이후 단계에서 붙여넣습니다.

    샘플 앱의 경우 debug 지문을 사용합니다.

  5. Google Cloud 프로젝트에서 OAuth 클라이언트 ID를 만듭니다.

  6. SHA-1 디지털 지문 필드에 이전 단계의 SHA-1 디지털 지문을 붙여넣습니다.

  7. 만들기를 클릭하여 OAuth 클라이언트 ID를 만듭니다.

필수 라이브러리 포함

샘플 앱의 build.gradle 파일에서 Android용 Google 로그인을 포함하도록 Google Play 서비스를 설정합니다.

dependencies {
  // Apps must declare play-services-auth version >= 16.
  // In the following line, substitute `16 (or later)` with the latest version.
  implementation 'com.google.android.gms:play-services-auth:16 (or later)'
}

샘플 앱 실행

Android 스튜디오에서 샘플 앱을 실행합니다.

기기의 현재 지리정보 포즈를 설명하는 디버그 정보와 함께 카메라 뷰가 표시될 수 있습니다. 주변 환경을 스캔할 때 VPS 현지화가 지원되는 영역에 있으면 이동함에 따라 위치 정확도 신뢰도 값이 변경될 수 있습니다.

ARCore는 기기의 위치와 방향이 확신할 때 지리 공간 포즈를 사용하여 현재 위치에 앵커를 배치할 수 있습니다.

VPS 정보를 사용할 수 없으면 포지셔닝 정확도가 지나치게 낮을 수 있습니다. 앱이 인터넷에 연결되어 있어야 하며 위치가 VPS에 알려져 있어야 합니다. 최상의 결과를 얻으려면 낮 시간 동안 (실외가 아닌) 샘플 앱을 실행하세요.

또한 VPS를 지원하지 않는 영역에 있거나 GPS 신호가 충분하지 않은 경우, 앵커 배치를 위해 앱의 신뢰도 임곗값을 조정해야 할 수도 있습니다.

임곗값을 조정하려면 다음 단계를 따르세요.

  1. Android 스튜디오에서 GeospatialActivity를 열고 다음 섹션으로 이동합니다.

    // The thresholds that are required for horizontal and heading accuracies before entering into the
    // LOCALIZED state. Once the accuracies are equal or less than these values, the app will
    // allow the user to place anchors.
    private static final double LOCALIZING_HORIZONTAL_ACCURACY_THRESHOLD_METERS = 10;
    private static final double LOCALIZING_HEADING_ACCURACY_THRESHOLD_DEGREES = 15;
    
  2. 필요에 따라 값을 조정합니다. 값이 클수록 정확도가 낮습니다.

    정확도를 낮추면 앱을 고정할 때 위도가 더 높아집니다. 자세한 내용은 포즈 정확성 조정을 참고하세요.

다음 단계