Android용 Maps SDK 빠른 참조

Android용 Maps SDK는 Wear OS 앱을 비롯한 Android 앱에 Google 지도 데이터, 지도 표시, 지도 동작 응답을 추가합니다. Kotlin 또는 Java를 사용하여 마커, 다각형, 오버레이를 추가하여 지도 위치에 관한 정보를 표시하고 사용자 상호작용을 지원할 수 있습니다.

Android용 Maps SDK: 주요 정보

  • 제품: Android용 Maps SDK
  • 다른 이름: Google Maps Android API
  • 카테고리: 지도
  • 플랫폼: Android
  • 실행 위치: 클라이언트(앱 또는 브라우저 코드)
  • 출시 단계: GA
  • 수명 주기: 활성
  • 개요: Android용 Maps SDK 개요
  • 신청 가능 지역: 전 세계 Google Maps Platform 서비스 범위 페이지를 참고하세요. 사용량 및 결제 페이지 링크는 전 세계 가격 목록과 인도 가격 목록을 구분합니다. (보증 범위 세부정보)

Android용 Maps SDK: 사용 시기

다음과 같은 경우 Android용 Maps SDK를 사용하세요.

  • 네이티브 Android 또는 Wear OS 앱에 양방향 2D Google 지도가 필요합니다.
  • Android 앱의 지도에 마커, 정보 창, 다중선, 다각형, 지면 오버레이 또는 타일 오버레이를 추가해야 합니다.
  • Android 앱에서 스트리트 뷰 파노라마, 라이트 모드(비트맵) 지도 또는 지도 ID가 있는 클라우드 기반 지도 스타일 지정이 필요합니다.
  • 지도 Compose 라이브러리를 통해 Jetpack Compose를 포함하여 Kotlin 또는 자바로 Android 지도를 빌드합니다.

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

  • Android 지도 앱에 세부 경로 안내 내비게이션이 필요합니다. 대신 Android용 Navigation SDK를 사용하세요.
  • Android 앱에 사실적인 3D 지도, 3D 모델 또는 카메라 경로 애니메이션이 필요합니다. 대신 Android용 지도 3D SDK를 사용하세요.
  • 네이티브 iOS 앱에 지도가 필요합니다. 대신 iOS용 Maps SDK를 사용하세요.

Android용 Maps SDK: 설정

공식 Android용 Maps SDK 패키지:

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

Android용 Maps SDK: 일반적인 실수

  • 문제: SDK v20.0.0부터 SDK 매니페스트에 더 이상 org.apache.http.legacy 라이브러리가 포함되지 않습니다. 기존 지도 렌더기를 로드하는 앱이 java.lang.NoClassDefFoundError로 인해 비정상 종료될 수 있습니다. 해결 방법: 앱 AndroidManifest.xml의 태그 내에 를 추가합니다. Google Play 서비스 25.50.34 이상이 설치된 기기는 영향을 받지 않습니다. /maps/documentation/android-sdk/release-notes를 참고하세요.
  • 문제: 고급 마커에는 업그레이드된 지도 렌더기가 필요합니다. 다시 빌드하지 않고 기존 앱에 추가하면 앱에서 기존 렌더기를 계속 사용할 수 있습니다. 해결 방법: 업그레이드된 렌더기가 기본값이 되도록 SDK 18.2.0 이상으로 앱을 다시 빌드합니다. /maps/documentation/android-sdk/advanced-markers/start를 참고하세요.
  • 문제: 렌더기 요구사항(Android 5.0/API 21 이상, Google Play 서비스 21.39.14 이상, Play 스토어 사용 설정됨)을 충족하지 않는 기기는 기존 렌더기로 대체되므로 클라우드 기반 지도 스타일 지정과 같이 새 렌더기가 필요한 기능을 사용할 수 없습니다. 해결 방법: MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback)를 호출하고 OnMapsSdkInitializedCallback.onMapsSdkInitialized()에 전달된 MapsInitializer.Renderer 값을 확인하거나 GoogleMap.getMapCapabilities()를 확인합니다. 기기에서 LEGACY를 사용하는 경우 클라우드 기반 지도 스타일 지정 또는 고급 마커를 사용하지 마세요. /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback을 참고하세요.
  • 문제: SDK를 사용하려면 앱이 실행되는 기기에 Google Play 서비스가 설치되어 있어야 합니다. 해결 방법: 앱에서 Google Play 서비스 사용 가능 여부 확인을 호출합니다(선택사항). /maps/documentation/android-sdk/config를 참고하세요.

Android용 Maps SDK: 기존 및 지원 중단된 기능

  • 기존 지도 렌더러: 2024년 3월 4일부터 지원 중단되었습니다. 대체: 업그레이드된 (최신) 지도 렌더기(SDK 18.2.0부터 기본값임) 증상: 기존 렌더기에서는 클라우드 기반 지도 스타일 지정, 고급 다중선 맞춤설정, 고급 마커를 사용할 수 없습니다. 이전 가이드를 참고하세요.

Android용 Maps SDK로 할 수 있는 작업

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

Android용 Maps SDK: 경계를 위한 데이터 기반 스타일 지정

Android용 Maps SDK: 데이터 세트를 위한 데이터 기반 스타일 지정

Android용 Maps SDK: 데이터 세트

Android용 Maps SDK: 지도

Android용 Maps SDK: 지도 주석

Android용 Maps SDK: 지도 스타일 지정

Android용 Maps SDK: 스트리트 뷰