Android용 지리정보 빠른 시작

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

Geospatial API를 사용하여 자체 앱을 개발하는 방법에 대한 가이드는 다음을 참조하세요. Android용 지리정보 개발자 가이드 (Kotlin/Java) 또는 Android NDK (C)용 지리정보 개발자 가이드

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

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

요구사항

기기 지원

ARCore와 호환되도록 인증된 기기의 전체 목록은 지원되는 기기를 참고하세요. Geospatial API의 경우 Geospatial API를 충족하는 자기계가 필요한 하드웨어 지정할 수도 있습니다 일부 자기계는 사양을 충족하지 않습니다. 이 기능이 있는 기기 규격을 벗어난 자기계는 지원되지 않습니다.

소프트웨어

  • 최신 버전의 Google Play AR 서비스 지원되는 기기에 설치되어 있어야 합니다.

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

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

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

다음 단계