Android용 지도 3D SDK 빠른 참조

Android용 지도 3D SDK를 사용하면 Android 앱에서 Google의 3D 이미지로 빌드된 대화형 3D 지도를 표시할 수 있습니다. 마커, 팝오버, 다중선, 다각형, glTF 3D 모델, 카메라 경로 애니메이션, 사용자 상호작용 및 카메라 움직임을 위한 컨트롤을 제공합니다.

Android용 지도 3D SDK: 주요 사실

  • 제품: Android용 지도 3D SDK
  • 다른 이름: 지도 3D Android SDK
  • 카테고리: 지도
  • 플랫폼: Android
  • 실행 위치: 클라이언트(앱 또는 브라우저 코드)
  • 출시 단계: GA
  • 수명 주기: 활성
  • 개요: Android용 지도 3D SDK 개요
  • 신청 가능 지역: 제한적입니다. 사용 가능 여부는 국가 및 지역에 따라 다릅니다. Google Maps Platform 지원 범위 페이지의 지도 3D(JavaScript, Android, iOS) 열을 참고하세요. (보증 범위 세부정보)

Android용 지도 3D SDK: 사용 시기

다음과 같은 경우 Android용 지도 3D SDK를 사용하세요.

  • Android 앱에서 실제 위치를 보여주는 대화형 포토리얼리스틱 3D 지도를 표시해야 합니다.
  • Android 앱의 3D 지도에 마커, 팝오버, 다중선, 다각형 또는 glTF 3D 모델을 배치해야 합니다.
  • 3D 지도에서 지점 간에 사용자를 안내하는 사전 정의된 카메라 애니메이션(이동, 주변 이동)이 필요합니다.
  • Android 앱의 3D 지도에서 사용자가 사용할 수 있는 카메라 움직임과 UI 컨트롤을 제어해야 합니다.

다음과 같은 경우에는 Android용 지도 3D SDK를 사용하지 마세요.

  • 3D 지도가 필요한 웹 앱을 빌드하고 있습니다. 대신 Maps JavaScript API를 사용하세요.
  • 3D 지도가 필요한 iOS 앱을 빌드하고 있습니다. 대신 iOS용 지도 3D SDK를 사용하세요.
  • Android 앱에 프로덕션에 즉시 사용 가능한 표준 2D 도로 지도가 필요합니다(이 SDK의 ROADMAP 모드는 실험용임). 대신 Android용 Maps SDK를 사용하세요.

Android용 지도 3D SDK: 설정

공식 Android용 지도 3D SDK 패키지:

  • maven: com.google.android.gms:play-services-maps3d

Android용 지도 3D SDK: 일반적인 실수

  • 문제: 지도가 로드될 때 지도 모드가 지정되지 않으면 지도가 로드되지 않습니다. 수정: 항상 레이아웃 XML(map3d:mapMode) 또는 setMapMode/Map3DInitConfig를 사용하여 Map3DMode(SATELLITE, HYBRID 또는 ROADMAP)를 설정합니다. /maps/documentation/maps-3d/android-sdk/map-modes를 참고하세요.
  • 문제: 클릭 리스너(지도 및 마커 클릭)가 기본 UI 스레드에서 실행되지 않으므로 핸들러의 직접 UI 업데이트가 실패합니다. 수정: UI를 업데이트하기 전에 기본 스레드로 전환합니다(예: lifecycleScope.launch(Dispatchers.Main) 사용). /maps/documentation/maps-3d/android-sdk/add-a-marker를 참고하세요.
  • 문제: 지도 상태가 Map3DView 인스턴스 간에 공유되므로 이전 뷰의 마커, 오버레이, 카메라 위치가 새 뷰로 이월됩니다. 해결 방법: 활성 Map3DView를 하나만 유지하고 이전 인스턴스에서 onDestroy()를 호출하고 마커, 오버레이를 수동으로 지우고 GoogleMap3D를 통해 카메라를 재설정합니다. /maps/documentation/maps-3d/android-sdk/add-a-3d-map을 참고하세요.
  • 문제: 기본적으로 기본 지도 관심 장소를 탭하면 Places UI 위젯이 표시되며, 이 위젯에는 Places SDK 종속 항목도 필요합니다. 수정: Android용 Places SDK 종속 항목을 추가하고, 기본 위젯을 원하지 않는 경우 OnMap3DClickListener의 onMap3DClick에서 true를 반환하여 기본 위젯을 표시하지 않습니다. /maps/documentation/maps-3d/android-sdk/points-of-interest를 참고하세요.

Android용 지도 3D SDK로 할 수 있는 작업

각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.