Referensi cepat Navigation SDK for Android

Navigation SDK for Android menambahkan navigasi belokan demi belokan Google Maps ke aplikasi Android, dengan penyesuaian UI dan konfigurasi rute. Library ini menyertakan lapisan peta Maps SDK, sehingga aplikasi yang menggunakannya juga tidak dapat menyertakan Maps SDK for Android.

Navigation SDK for Android: fakta penting

  • Produk: Navigation SDK for Android
  • Juga dikenal sebagai: Navigation SDK
  • Kategori: Rute
  • Platform: Android
  • Berjalan di: Klien (kode aplikasi atau browser)
  • Tahap peluncuran: GA
  • Siklus proses: Aktif
  • Ringkasan: Ringkasan Navigation SDK for Android

Navigation SDK for Android: kapan harus menggunakannya

Gunakan Navigation SDK for Android jika:

  • Anda memerlukan navigasi belokan demi belokan Google Maps di dalam aplikasi Android Anda sendiri agar pengguna tidak beralih ke aplikasi lain.
  • Anda perlu menyesuaikan UI navigasi agar sesuai dengan merek Anda, atau membuat pengalaman navigasi kustom.
  • Anda memerlukan navigasi dalam aplikasi untuk mengemudi, berjalan kaki, bersepeda, atau kendaraan roda dua.
  • Anda harus menavigasi rute yang Anda rencanakan dengan Routes API dengan meneruskan token rute ke SDK.

Jangan gunakan Navigation SDK for Android jika:

Navigation SDK for Android: penyiapan

Paket Navigation SDK for Android resmi:

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

Navigation SDK for Android: kesalahan umum

  • Masalah: Navigation SDK sudah memaketkan Maps SDK. Build yang menarik play-services-maps secara langsung atau melalui dependensi transitif akan menghasilkan salinan Maps SDK duplikat. Perbaikan: Kecualikan com.google.android.gms:play-services-maps dari semua dependensi (pengecualian konfigurasi Gradle atau pengecualian Maven), dan hapus dependensi Maps SDK langsung. Lihat /maps/documentation/navigation/android-sdk/android-studio-setup.
  • Masalah: Navigation SDK 8.0 dan yang lebih baru mendeklarasikan minAndroidGradlePluginVersion=9.0.1, sehingga build dengan AGP yang lebih lama akan gagal. Perbaikan: Upgrade ke AGP 9.0.1, Gradle 9.1.0, dan Kotlin 2.3.0 sebelum Anda melakukan build dengan 8.0+. Lihat /maps/documentation/navigation/android-sdk/kotlin-compatibility-migration.
  • Masalah: Memanggil metode siklus proses NavigationView secara langsung saat menggunakan NavigationFragment, atau memanggilnya tidak sesuai urutan dengan NavigationView, akan menyebabkan error. Perbaikan: Gunakan NavigationFragment, yang mengelola callback siklus proses. Jika Anda menggunakan NavigationView, teruskan metode siklus proses dalam urutan yang ketat. Lihat /maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices.
  • Masalah: Navigasi tidak tersedia hingga pengguna menyetujui Persyaratan Layanan Google Navigasi. Perbaikan: Biarkan SDK menampilkan dialog saat pertama kali navigator dipanggil, atau tampilkan dialog lebih awal (misalnya selama pendaftaran) dengan TermsAndConditionsCheckOption / NavigationApi.showTermsAndConditionsDialog. Lihat /maps/documentation/navigation/android-sdk/route.

Navigation SDK for Android: fitur lama dan tidak digunakan lagi

  • Waypoint fromLatLng() dan fromPlaceId(): Dinonaktifkan sejak 10-05-2021. Pengganti: Waypoint.builder() (Waypoint.Builder). Gejala: Dihapus di versi 3.0; panggilan tidak dikompilasi terhadap versi 3.0 atau yang lebih baru. Lihat panduan migrasi.
  • SupportNavigationFragment: Tidak digunakan lagi sejak 01-10-2026. Penggantian: NavigationFragment. Gejala: Tidak digunakan lagi di Navigation SDK v8.0.0. Lihat panduan migrasi.
  • setLocationMarkerEnabled di NavigationView dan SupportNavigationFragment: Dinonaktifkan sejak 07-07-2023. Penggantian: GoogleMap.setMyLocationEnabled. Gejala: Dihapus di versi 5.0.0 (tidak digunakan lagi di 4.1); panggilan tidak dikompilasi terhadap 5.0 atau yang lebih baru.
  • DisplayOptions showTrafficLights dan showStopSigns: Dinonaktifkan sejak 01-10-2026. Pengganti: Tidak perlu pengganti; lampu lalu lintas dan tanda berhenti selalu diaktifkan selama navigasi. Gejala: Panggilan ke metode ini tidak dikompilasi terhadap versi 8.0.0.
  • Artefak Maven com.google.android.maps:navsdk (repositori pribadi, v4.x) dan download paket AAR: Dinonaktifkan sejak 07-07-2023. Pengganti: com.google.android.libraries.navigation:navigation dari repositori Maven google(). Gejala: Versi 5.0 dan yang lebih baru hanya dikirim sebagai com.google.android.libraries.navigation:navigation di Google Maven; paket AAR tidak lagi didistribusikan. Lihat panduan migrasi.

Yang dapat Anda lakukan dengan Navigation SDK for Android

Lihat panduan yang ditautkan di bawah untuk setiap tugas, atau bandingkan berbagai produk di Penjelajah Kemampuan.

Navigation SDK for Android: Maps

Navigation SDK for Android: Anotasi peta

Navigation SDK untuk Android: Gaya peta

Navigation SDK for Android: Navigasi