Geospatial API 문제 해결

적용 가능한 XR 기기
이 가이드는 이러한 유형의 XR 기기를 위한 환경을 빌드하는 데 도움이 됩니다.
XR 기기 유형 알아보기 →
유선 XR 글라스
오디오 및
디스플레이 안경
XR 기기 유형 알아보기 →

Geospatial API에 문제가 있는 경우 다음과 같은 일반적인 단계를 따르세요.

API 키 승인이 성공하지 않음

API 키 승인이 작동하지 않는 경우 다음 단계를 따르세요.

  • Google Cloud에서 올바른 프로젝트에 ARCore API를 사용 설정했는지 확인합니다.
  • API 키 제한이 사용 설정되어 있으면 일시적으로 사용 중지합니다.

  • APK Analyzer를 사용하여 API 키가 앱 빌드에 포함되어 있는지 확인합니다. 앱의 AndroidManifest.xml에 있는 <application> 요소의 <meta-data> 요소에 있어야 합니다.

    <meta-data
  android:name="com.google.android.ar.API_KEY"
  android:value="API_KEY"/>

  • 프로젝트의 사용자 인증 정보에 나열된 API 키가 앱에서 사용하는 API 키와 정확히 일치하는지 확인합니다. 공백이나 다른 문자가 없어야 합니다.

Geospatial 위치 파악 품질이 예상 값에 도달하지 않음

Geospatial API에서 반환된 포즈의 품질이 예상 결과에 미치지 못하는 경우 다음과 같은 원인이 있을 수 있습니다.

  • 공식 Google 스트리트 뷰 소스에서 매핑하지 않은 지역입니다.
    • 확인하려면 Google 지도를 열고 예상 위치 지정 위치 근처에서 스트리트 뷰를 입력합니다. 스트리트 뷰 이미지의 저작자 표시는 Google 스트리트 뷰여야 합니다. 다른 소스는 VPS에 고려되지 않습니다.
  • 제한된 지역에 있는 구역입니다.
  • 영역에 적합한 특징점이 충분하지 않습니다.
    • VPS는 장기간 변경될 가능성이 없는 고품질 특징점만 사용합니다. 예를 들어 나무는 연중 외관이 많이 달라질 수 있으므로 특징점으로 사용하기에 적합하지 않습니다.
    • 최근에 촬영된 Google 스트리트 뷰와 비교했을 때 인프라 공사로 인해 지역이 크게 변경되었을 수 있습니다.