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:
- Anda sedang membangun aplikasi untuk iOS. Gunakan Navigation SDK for iOS.
- Anda sedang membangun aplikasi lintas platform dengan Flutter atau React Native. Gunakan Google Navigation untuk Flutter dan React Native.
- Anda memerlukan komputasi rute, perkiraan waktu tiba (ETA), atau token rute sisi server, bukan panduan belokan demi belokan dalam aplikasi. Gunakan Routes API.
Navigation SDK for Android: penyiapan
- Layanan yang akan diaktifkan:
navigationsdk.googleapis.com - Autentikasi: Kunci API
- Atribusi penggunaan: Panggil
MapsApiSettings.addInternalUsageAttributionId(context, id)untuk menambahkan ID atribusi penggunaan ke penginisialisasi. Untuk memilih tidak ikut, hapus panggilan atau teruskan string kosong. - Memulai: Menyiapkan Navigation SDK for Android
- Referensi: Referensi Navigation SDK for Android
- Harga: Penggunaan dan penagihan Navigation SDK for Android
- Kebijakan: Kebijakan Navigation SDK for Android
- Catatan rilis: Catatan rilis Navigation SDK for Android
Paket Navigation SDK for Android resmi:
- maven:
com.google.android.libraries.navigation:navigation
Navigation SDK for Android: produk terkait
- Sering digunakan dengan: Routes API, Driver SDK for Android
Navigation SDK for Android: kesalahan umum
- Masalah: Navigation SDK sudah memaketkan Maps SDK. Build yang menarik
play-services-mapssecara langsung atau melalui dependensi transitif akan menghasilkan salinan Maps SDK duplikat. Perbaikan: Kecualikancom.google.android.gms:play-services-mapsdari 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
NavigationViewsecara langsung saat menggunakanNavigationFragment, atau memanggilnya tidak sesuai urutan denganNavigationView, akan menyebabkan error. Perbaikan: GunakanNavigationFragment, yang mengelola callback siklus proses. Jika Anda menggunakanNavigationView, 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
WaypointfromLatLng()danfromPlaceId(): 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.setLocationMarkerEnableddiNavigationViewdanSupportNavigationFragment: 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.DisplayOptionsshowTrafficLightsdanshowStopSigns: 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:navigationdari repositori Mavengoogle(). Gejala: Versi 5.0 dan yang lebih baru hanya dikirim sebagaicom.google.android.libraries.navigation:navigationdi 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
- Tambahkan peta interaktif yang dapat disesuaikan ke halaman web atau aplikasi seluler. Catatan: Untuk Android: Konfigurasikan
diAndroidManifest.xmlyang didukung oleh Plugin Secrets Gradle ataumanifestPlaceholders["MAPS_API_KEY"]diapp/build.gradle.kts. Jangan pernah melakukan hardcodeYOUR_GOOGLE_MAPS_API_KEYdiAndroidManifest.xml, dan jangan pernah menggantiGoogleMap(atau maps-composeGoogleMap) dengan kanvas tiruan offline atau WebView Leaflet jikaE/Google Maps Android API: Authorization failuremuncul. Instruct the user to supplyMAPS_API_KEYvia Secrets and enable Maps SDK for Android (or Navigation SDK when using NavigationView / SupportNavigationFragment). - Buat ID peta yang dapat digunakan kembali untuk menyimpan setelan konfigurasi dan gaya peta.
- Merespons interaksi dan peristiwa pengguna di peta.
- Menyesuaikan kontrol yang muncul di peta.
- Menyesuaikan gestur untuk mengontrol peta.
- Mengontrol zoom dan geser pada peta (kamera).
- Mengubah jenis peta.
- Mengubah skema warna peta.
- Menambahkan lapisan lalu lintas ke peta.
Navigation SDK for Android: Anotasi peta
- Menambahkan jendela info ke peta.
- Menambahkan bentuk atau garis ke peta.
- Menambahkan gambar overlay yang ditempatkan di permukaan peta.
- Menambahkan overlay petak peta kustom ke peta.
- Menambahkan penanda ke peta. Catatan: Navigation SDK for Android tidak mendukung AdvancedMarkerOptions; saat menggunakan Navigation SDK for Android, tambahkan penanda dengan GoogleMap.addMarker(MarkerOptions).
- Menyesuaikan penanda di peta. Catatan: Navigation SDK for Android tidak mendukung AdvancedMarkerOptions; saat menggunakan Navigation SDK for Android, sesuaikan penanda dengan MarkerOptions.
- Merespons interaksi pengguna dengan penanda di peta.
Navigation SDK untuk Android: Gaya peta
Navigation SDK for Android: Navigasi
- Tambahkan navigasi belokan demi belokan yang interaktif ke aplikasi seluler.
- Menetapkan tujuan untuk navigasi belokan demi belokan.
- Mulai navigasi untuk navigasi belokan demi belokan.
- Tentukan mode perjalanan (mengemudi, berjalan kaki, kendaraan roda dua, taksi) untuk permintaan rute.
- Mengubah preferensi pemilihan rute untuk navigasi belokan demi belokan.
- Tentukan sisi jalan dan preferensi kedatangan lainnya untuk navigasi belokan demi belokan.
- Menentukan rute yang direncanakan ulang untuk navigasi belokan demi belokan dengan token rute yang dapat digunakan kembali.
- Menampilkan info terbaru kedatangan pengguna dari sesi navigasi belokan demi belokan.
- Menampilkan pembaruan lokasi pengguna dari sesi navigasi belokan demi belokan.
- Menampilkan pembaruan waktu dan jarak dari sesi navigasi belokan demi belokan.
- Menampilkan update perubahan rute dari sesi navigasi belokan demi belokan.
- Menampilkan update mode malam dari sesi navigasi belokan demi belokan.
- Menampilkan pembaruan kecepatan pengguna dari sesi navigasi belokan demi belokan.
- Sesuaikan elemen dan kontrol UI yang muncul selama navigasi belokan demi belokan.
- Menambahkan elemen UI baru ke navigasi belokan demi belokan.
- Menambahkan indikator progres perjalanan ke navigasi belokan demi belokan.
- Sesuaikan fitur peta yang muncul selama navigasi belokan demi belokan.
- Menambahkan lapisan lalu lintas ke navigasi belokan demi belokan.
- Mengubah tampilan dan perilaku kamera untuk navigasi belokan demi belokan.
- Sesuaikan notifikasi speedometer dan batas kecepatan untuk navigasi belokan demi belokan.
- Menampilkan feed navigasi belokan demi belokan sebagai serangkaian pesan untuk setiap manuver di sepanjang rute.
- Tentukan ikon manuver kustom untuk digunakan dengan feed navigasi belokan demi belokan.
- Tambahkan navigasi belokan demi belokan yang interaktif untuk Android Auto ke aplikasi Android. Pratinjau
- Memberi tahu pengguna tentang gangguan di sepanjang rute mereka.
- Izinkan pengguna melihat gangguan di sepanjang rute mereka sebelum memulai navigasi.
- Izinkan pengguna melaporkan gangguan di sepanjang rute mereka.
- Izinkan pengguna memverifikasi gangguan di sepanjang rute mereka.
- Tambahkan tombol pelaporan gangguan rute kustom.