Android용 Navigation SDK 빠른 참조

Android용 Navigation SDK는 UI 맞춤설정 및 경로 구성을 통해 Android 앱에 Google 지도 세부 경로 안내 내비게이션을 추가합니다. Maps SDK 지도 레이어가 포함되어 있으므로 이를 사용하는 앱은 Android용 Maps SDK를 포함할 수 없습니다.

Android용 Navigation SDK: 주요 정보

  • 제품: Android용 Navigation SDK
  • 다른 이름: Navigation SDK
  • 카테고리: 경로
  • 플랫폼: Android
  • 실행 위치: 클라이언트(앱 또는 브라우저 코드)
  • 출시 단계: GA
  • 수명 주기: 활성
  • 개요: Android용 Navigation SDK 개요

Android용 Navigation SDK: 사용 시기

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

  • 사용자가 다른 앱으로 전환하지 않도록 자체 Android 앱 내에 Google 지도 세부 경로 안내 내비게이션이 필요합니다.
  • 브랜드에 맞게 탐색 UI를 맞춤설정하거나 맞춤 탐색 환경을 빌드해야 합니다.
  • 운전, 도보, 자전거 또는 이륜차를 위한 인앱 내비게이션이 필요합니다.
  • 경로 토큰을 SDK에 전달하여 Routes API로 계획한 경로를 탐색해야 합니다.

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

  • iOS용 앱을 빌드하는 경우 대신 iOS용 Navigation SDK를 사용하세요.
  • Flutter 또는 React Native를 사용하여 크로스 플랫폼 앱을 빌드하는 경우 대신 Flutter 및 React Native용 Google Navigation을 사용하세요.
  • 인앱 세부 경로 안내가 아닌 서버 측 경로, ETA 또는 경로 토큰 계산이 필요합니다. 대신 Routes API를 사용하세요.

Android용 Navigation SDK: 설정

Android용 Navigation SDK 공식 패키지:

  • maven: com.google.android.libraries.navigation:navigation

Android용 Navigation SDK: 일반적인 실수

  • 문제: Navigation SDK에는 이미 Maps SDK가 번들로 포함되어 있습니다. play-services-maps를 직접 또는 전이 종속 항목을 통해 가져오는 빌드에는 중복된 Maps SDK 사본이 포함됩니다. 해결 방법: 모든 종속 항목(Gradle 구성 제외 또는 Maven 제외)에서 com.google.android.gms:play-services-maps를 제외하고 직접적인 Maps SDK 종속 항목을 삭제합니다. /maps/documentation/navigation/android-sdk/android-studio-setup을 참고하세요.
  • 문제: Navigation SDK 8.0 이상에서는 minAndroidGradlePluginVersion=9.0.1를 선언하므로 이전 AGP를 사용하는 빌드가 실패합니다. 해결 방법: 8.0 이상으로 빌드하기 전에 AGP 9.0.1, Gradle 9.1.0, Kotlin 2.3.0으로 업그레이드하세요. /maps/documentation/navigation/android-sdk/kotlin-compatibility-migration을 참고하세요.
  • 문제: NavigationFragment를 사용하는 동안 NavigationView 수명 주기 메서드를 직접 호출하거나 NavigationView를 사용하여 순서에 맞지 않게 호출하면 오류가 발생합니다. 수정: 수명 주기 콜백을 관리하는 NavigationFragment를 사용합니다. NavigationView를 사용하는 경우 수명 주기 메서드를 엄격한 순서로 전달합니다. /maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices를 참고하세요.
  • 문제: 사용자가 Google 내비게이션 서비스 약관에 동의할 때까지 내비게이션을 사용할 수 없습니다. 해결 방법: SDK가 내비게이터를 처음 호출할 때 메시지를 표시하도록 하거나 TermsAndConditionsCheckOption / NavigationApi.showTermsAndConditionsDialog를 사용하여 대화상자를 더 일찍(예: 가입 중에) 표시합니다. /maps/documentation/navigation/android-sdk/route를 참고하세요.

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

  • Waypoint fromLatLng() 및 fromPlaceId(): 2021년 5월 10일부터 사용 중단되었습니다. 대체: Waypoint.builder()(Waypoint.Builder). 증상: 버전 3.0에서 삭제되었습니다. 호출이 버전 3.0 이상에서 컴파일되지 않습니다. 이전 가이드를 참고하세요.
  • SupportNavigationFragment: 2026년 10월 1일부터 지원 중단됩니다. 교체: NavigationFragment. 증상: Navigation SDK v8.0.0에서 지원 중단되었습니다. 이전 가이드를 참고하세요.
  • setLocationMarkerEnabledNavigationView 및 SupportNavigationFragment의: 2023년 7월 7일부터 사용 중단되었습니다. 교체: GoogleMap.setMyLocationEnabled. 증상: 버전 5.0.0에서 삭제되었습니다(4.1에서 지원 중단됨). 호출이 5.0 이상에서 컴파일되지 않습니다.
  • DisplayOptions showTrafficLights 및 showStopSigns: 2026년 10월 1일부터 사용 중단되었습니다. 대체: 대체가 필요하지 않습니다. 내비게이션 중에는 신호등과 정지 표지판이 항상 사용 설정됩니다. 증상: 이러한 메서드 호출이 버전 8.0.0에서 컴파일되지 않습니다.
  • Maven 아티팩트 com.google.android.maps:navsdk(비공개 저장소, v4.x) 및 AAR 번들 다운로드: 2023년 7월 7일부터 사용 중단되었습니다. 대체: google() Maven 저장소의 com.google.android.libraries.navigation:navigation. 증상: 버전 5.0 이상은 Google Maven에서 com.google.android.libraries.navigation:navigation로만 제공되며, AAR 번들은 더 이상 배포되지 않습니다. 이전 가이드를 참고하세요.

Android용 Navigation SDK로 할 수 있는 작업

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

Android용 Navigation SDK: 지도

Android용 Navigation SDK: 지도 주석

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

Android용 Navigation SDK: 내비게이션