Android용 지리정보 빠른 시작

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

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

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

ARCore로 처음 개발하는 경우 시작하기를 참고하세요.

요구사항

기기 지원

ARCore 호환 인증을 받은 기기의 전체 목록은 지원되는 기기를 참고하세요. Geospatial API의 경우 필요한 하드웨어의 핵심 요소 중 하나는 Geospatial API 사양을 충족하는 자기계입니다. 일부 자기계는 사양을 충족하지 않습니다. 이러한 사양 외 자기계가 있는 기기는 지원되지 않습니다.

소프트웨어

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

  • 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 (Visual Positioning System)를 사용하려면 앱을 ARCore API가 사용 설정된 Google Cloud 프로젝트와 연결해야 합니다. 승인을 설정하려면 Google Cloud에서 ARCore API 사용을 참고하세요. 키 없는 인증 또는 API 키 인증 중에서 선택할 수 있습니다.

샘플 앱 실행

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. 필요에 따라 값을 조정합니다. 값이 클수록 정확도가 낮습니다.

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

다음 단계