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: 설정
- 사용 설정할 서비스:
navigationsdk.googleapis.com - 인증: API 키
- 사용 기여 분석:
MapsApiSettings.addInternalUsageAttributionId(context, id)를 호출하여 초기화 도구에 사용 기여 분석 ID를 추가합니다. 선택 해제하려면 호출을 삭제하거나 빈 문자열을 전달합니다. - 시작하기: Android용 Navigation SDK 설정
- 참조: Android용 Navigation SDK 참조
- 가격 책정: Android용 Navigation SDK 사용량 및 결제
- 정책: Android용 Navigation SDK 정책
- 출시 노트: Android용 Navigation SDK 출시 노트
Android용 Navigation SDK 공식 패키지:
- maven:
com.google.android.libraries.navigation:navigation
Android용 Navigation SDK: 관련 제품
- 함께 자주 사용되는 API: Routes API, Android용 Driver SDK
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: 기존 및 지원 중단된 기능
WaypointfromLatLng()및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 이상에서 컴파일되지 않습니다.DisplayOptionsshowTrafficLights및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의 경우 Secrets Gradle 플러그인에서 지원하는
AndroidManifest.xml에서를 구성하거나app/build.gradle.kts에서manifestPlaceholders["MAPS_API_KEY"]를 구성합니다.AndroidManifest.xml에서YOUR_GOOGLE_MAPS_API_KEY를 하드코딩하지 말고,E/Google Maps Android API: Authorization failure가 표시되는 경우GoogleMap(또는 maps-composeGoogleMap)를 오프라인 모의 캔버스 또는 Leaflet WebView로 대체하지 마세요. 사용자에게 Secrets를 통해MAPS_API_KEY를 제공하고 Android용 Maps SDK(또는 NavigationView/SupportNavigationFragment를 사용하는 경우 Navigation SDK)를 사용 설정하도록 안내합니다. - 지도 구성 및 스타일 지정 설정을 저장하는 재사용 가능한 지도 식별자를 만듭니다.
- 지도에서 사용자 상호작용 및 이벤트에 응답합니다.
- 지도에 표시되는 컨트롤을 맞춤설정합니다.
- 지도를 제어하는 동작을 맞춤설정합니다.
- 지도(카메라)에서 확대/축소 및 화면 이동을 제어합니다.
- 지도 유형을 변경합니다.
- 지도 색 구성표를 변경합니다.
- 지도에 교통정보 레이어를 추가합니다.
Android용 Navigation SDK: 지도 주석
- 지도에 정보 창 추가
- 지도에 도형 또는 선을 추가합니다.
- 지도 표면에 고정된 오버레이 이미지를 추가합니다.
- 지도에 맞춤 타일 오버레이를 추가합니다.
- 지도에 마커를 추가합니다. 참고: Android용 Navigation SDK는 AdvancedMarkerOptions를 지원하지 않습니다. Android용 Navigation SDK를 사용하는 경우 GoogleMap.addMarker(MarkerOptions)를 사용하여 마커를 추가하세요.
- 지도에서 마커를 맞춤설정합니다. 참고: Android용 Navigation SDK는 AdvancedMarkerOptions를 지원하지 않습니다. Android용 Navigation SDK를 사용하는 경우 MarkerOptions를 사용하여 마커를 맞춤설정하세요.
- 지도의 마커를 사용한 사용자 상호작용에 응답합니다.
Android용 Navigation SDK: 지도 스타일 지정
Android용 Navigation SDK: 내비게이션
- 모바일 앱에 양방향 세부 경로 안내 내비게이션을 추가합니다.
- 세부 경로 안내 내비게이션의 목적지를 설정합니다.
- 세부 경로 안내 내비게이션을 시작합니다.
- 경로 요청에 이동 수단(운전, 도보, 오토바이, 택시)을 지정합니다.
- 세부 경로 안내 내비게이션의 경로 환경설정을 수정합니다.
- 세부 경로 안내 내비게이션의 도로변 및 기타 도착 환경설정을 지정합니다.
- 재사용 가능한 경로 토큰을 사용하여 세부 경로 안내 내비게이션의 재계획된 경로를 지정합니다.
- 세부 경로 안내 내비게이션 세션에서 사용자 도착 업데이트를 반환합니다.
- 세부 경로 안내 내비게이션 세션에서 사용자 위치 업데이트를 반환합니다.
- 세부 경로 안내 내비게이션 세션에서 시간 및 거리 업데이트를 반환합니다.
- 세부 경로 안내 내비게이션 세션에서 경로 변경 업데이트를 반환합니다.
- 세부 경로 안내 내비게이션 세션에서 야간 모드 업데이트를 반환합니다.
- 세부 경로 안내 내비게이션 세션에서 사용자 속도 업데이트를 반환합니다.
- 세부 경로 안내 내비게이션 중에 표시되는 UI 요소와 컨트롤을 맞춤설정합니다.
- 세부 경로 안내 내비게이션에 새 UI 요소를 추가합니다.
- 세부 경로 안내 내비게이션에 이동 진행률 표시기를 추가합니다.
- 세부 경로 안내 내비게이션 중에 표시되는 지도 지형지물을 맞춤설정합니다.
- 세부 경로 안내 내비게이션에 교통정보 레이어를 추가합니다.
- 세부 경로 안내 내비게이션의 카메라 뷰 및 동작을 수정합니다.
- 세부 경로 안내 내비게이션의 속도계 및 속도 제한 알림을 맞춤설정합니다.
- 경로를 따라 각 이동에 대한 일련의 메시지로 세부 경로 안내 내비게이션 피드를 반환합니다.
- 세부 경로 안내 내비게이션 피드에 사용할 맞춤 이동 아이콘을 지정합니다.
- Android 앱에 Android Auto용 대화형 세부 경로 안내 내비게이션을 추가합니다. 프리뷰
- 사용자에게 경로상의 혼잡 상황을 알립니다.
- 사용자가 내비게이션을 시작하기 전에 경로를 따라 발생하는 중단을 볼 수 있도록 허용합니다.
- 사용자가 경로에서 발생한 중단 상황을 신고할 수 있도록 허용합니다.
- 사용자가 경로상의 중단을 확인할 수 있도록 허용합니다.
- 맞춤 경로 중단 신고 버튼을 추가합니다.