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: 설정
- 사용 설정할 서비스:
mapsandroid.googleapis.com - 인증: API 키
- 시작하기: Android용 지도 3D SDK 설정
- 참조: Android용 지도 3D SDK 참조
- 가격 책정: Android용 지도 3D SDK 사용량 및 결제
- 정책: Android용 지도 3D SDK 정책
- 출시 노트: Android용 지도 3D SDK 출시 노트
공식 Android용 지도 3D SDK 패키지:
- maven:
com.google.android.gms:play-services-maps3d
Android용 지도 3D SDK: 관련 상품
- 함께 자주 사용되는 SDK: Android용 Places SDK
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로 할 수 있는 작업
각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.
- 웹페이지에 대화형 포토리얼리스틱 3D 지도를 추가합니다.
- 포토리얼리스틱 3D 지도에 마커를 추가합니다.
- 포토리얼리스틱 3D 지도에서 마커를 맞춤설정합니다.
- 포토리얼리스틱 3D 지도에 3D 모델을 추가합니다.
- 포토리얼리스틱 3D 지도에 3D 다중선을 추가합니다.
- 포토리얼리스틱 3D 지도에 3D 다각형을 추가합니다.
- 포토리얼리스틱 3D 지도에서 사용자 상호작용 및 이벤트에 응답합니다.
- 포토리얼리스틱 3D 지도에 표시되는 컨트롤을 맞춤설정합니다.
- 실사 수준의 3D 지도에서 카메라 경로와 애니메이션을 제어합니다.
- 포토리얼리스틱 3D 지도에서 카메라 제한을 제어합니다.