Dengan mengintegrasikan Navigation SDK untuk Android, aplikasi Anda tidak hanya dapat menautkan ke tampilan peta eksternal. Dengan navigasi Google Maps, aplikasi Anda dapat menawarkan pengambilan dinamis dan pelaporan data dengan tampilan tunggal tentang perjalanan pengguna. Panduan ini menjelaskan cara menjalankan aplikasi demo Navigation SDK, yang tersedia di GitHub.
Bersiaplah
Untuk memulai Navigation SDK, pastikan Anda memiliki item berikut.
Perwakilan Google Maps Platform untuk akses ke hal berikut:
- Kunci API yang disediakan untuk digunakan dengan Navigation SDK. Anda harus memberikan projectID yang dapat ditemukan di dasbor utama Konsol Google Cloud, di bawah nama project.
- Artefak SDK. Pastikan project Anda dikonfigurasi untuk menggunakan Maven untuk Navigation SDK.
- Untuk project yang menggunakan v4.99.0 dan yang lebih lama. Jika tidak dapat menggunakan Maven, Anda
dapat mendownload artefak yang di-zip dari Google Drive bersama. File library statis adalah .aar di
direktori
libs/
yang berisi Navigation SDK sebagai paket AAR. - Satu atau beberapa aplikasi demo.
- Android Studio, lingkungan pengembangan yang direkomendasikan untuk membangun aplikasi dengan Navigation SDK.
Dokumentasi ini didesain untuk orang yang memahami pengembangan Android dan konsep pemrograman berorientasi objek. Anda juga harus memahami Google Maps dari sudut pandang pengguna.
Mendapatkan aplikasi demo
Google menyediakan dua aplikasi untuk membantu Anda memahami apa yang ditawarkan Navigation SDK selain dari Google Maps API, bergantung pada tingkat pengalaman Anda. Developer yang terbiasa dengan Google Maps API dapat memfokuskan perhatian mereka pada demo GoogleNavigation. Developer yang baru mengenal kedua project akan merasa terbantu oleh kedua aplikasi tersebut.
Mulai Navigation SDK for Android v4.1, aplikasi demo berikut tersedia di GitHub untuk didownload.
Demo GoogleNavigation: Menunjukkan integrasi perilaku dan tampilan API karena berkaitan dengan pengalaman pengguna saat berada dalam sesi navigasi terpandu.
Demo GoogleMap: menunjukkan perilaku individual antarmuka
GoogleMap
untuk menyesuaikan nuansa dan penyajian peta.
Catatan tentang penggunaan Maven
Aplikasi demo dikonfigurasi untuk mendownload artefak SDK dari repositori Maven jarak jauh, menggunakan plugin Artifact Registry di Gradle. Pastikan untuk mengikuti petunjuk konfigurasi project untuk mendapatkan akses ke SDK.
Demo GoogleNavigation
Demo GoogleNavigation terbaru tersedia di GitHub.
Gedung
Di Android Studio, impor aplikasi demo dan izinkan Gradle berjalan.
Buka
local.defaults.properties
dan perbarui nilai propertiMAPS_API_KEY
:MAPS_API_KEY=YOUR_API_KEY
Klik build dan periksa detail penerapan SDK.
Di class Java, perhatikan kode implementasi.
Dalam XML tata letak, perhatikan desain tata letak dan teksnya.
Dalam file
build.gradle
, perhatikan SDK dalam dependensi.
Lihat dokumentasi plugin Secrets Gradle untuk informasi selengkapnya tentang cara kunci API ditambahkan ke manifes.
Berjalan
Hubungkan perangkat Android ke komputer Anda atau gunakan emulator.
- Perangkat Android—Lihat instructions untuk mengaktifkan opsi developer di perangkat Android Anda dan mengonfigurasi sistem guna mendeteksi perangkat tersebut.
- Emulatormdash;Gunakan Android Virtual Device (AVD) Manager untuk mengonfigurasi perangkat virtual. Saat memilih emulator, pastikan Anda memilih image yang berisi Google API.
Di Android Studio, klik opsi menu Run (atau ikon tombol putar); lalu pilih target deployment.
Saat dibuat dan diluncurkan, aplikasi akan menyajikan halaman landing yang berisi daftar opsi kepada pengguna.
Opsi NavViewActivity dan NavFragmentActivity
Pengguna baru NavSDK kemungkinan akan menganggap kedua opsi ini paling berguna.
Opsi 1: NavViewActivity
menampilkan perilaku menggunakan NavigationView
bersama dengan
Navigator
.
Opsi 2: Opsi kedua, berjudul NavFragmentActivity
, menampilkan
perilaku menggunakan
SupportNavigationFragment
bersama
Navigator
.
Saat Anda mengklik salah satu opsi ini, Anda akan melihat hal berikut:
- UI navigasi
- tombol "Tetapkan Tujuan" di menu aplikasi
- overlay yang dapat berinteraksi dengan Anda untuk memanggil metode secara dinamis pada API
- menu tambahan dengan lebih banyak opsi
Untuk memulai, klik Tetapkan Tujuan, lalu pilih alamat. Aplikasi kemudian menyimulasikan perjalanan dari lokasi Anda saat ini ke alamat tersebut. Gunakan overlay panel kontrol untuk melihat apa yang terjadi saat Anda memanggil API. Misalnya, Anda dapat mengklik View Methods untuk mencoba memaksa SDK beralih ke mode malam untuk melihat tampilannya.
Opsi SwappingMapAndNavActivity
SwappingMapAndNavActivity
menampilkan pola umum berikut:
- menampilkan
MapView
- beralih ke
NavigationView
saat navigasi dimulai - kembali ke
MapView
saat navigasi berakhir
Demo GoogleMap
Demo GoogleNavigation terbaru tersedia di GitHub.
Gedung
Di Android Studio, impor aplikasi demo dan izinkan Gradle berjalan.
Buka
local.defaults.properties
dan perbarui nilai propertiMAPS_API_KEY
:MAPS_API_KEY=YOUR_API_KEY
Klik build dan periksa detail penerapan SDK.
Di class Java, perhatikan kode implementasi.
Dalam XML tata letak, perhatikan desain tata letak dan teksnya.
Dalam file
build.gradle
, perhatikan SDK dalam dependensi.
Lihat plugin gradle secret untuk informasi selengkapnya tentang cara menambahkan kunci API ke Manifes.
Berjalan
Hubungkan perangkat Android ke komputer Anda atau gunakan emulator.
- Perangkat Android Lihat instructions untuk mengaktifkan opsi developer di perangkat Android Anda dan mengonfigurasi sistem guna mendeteksi perangkat tersebut.
- Emulator Gunakan Android Virtual Device (AVD) Manager untuk mengonfigurasi perangkat virtual. Saat memilih emulator, pastikan Anda memilih image yang berisi Google API.
Di Android Studio, klik opsi menu Run (atau ikon tombol putar); lalu pilih target deployment.
Saat dibuat dan diluncurkan, aplikasi menyajikan halaman landing yang berisi daftar demo kepada pengguna.
Pola presentasi ini dan struktur kode sumber yang sesuai
harus tidak asing bagi pengguna demo Google Maps SDK. Hal ini karena
demo GoogleMap dirancang agar serupa dengan aplikasi demo
Maps API. Perbedaan utamanya adalah demo Navigation SDK memungkinkan pengguna memilih class tampilan
yang ingin mereka uji coba menjalankan demo:
NavigationView
atau
MapView
,
jika berlaku.
Google umumnya mendorong pengguna untuk menggunakan
NavigationView
.
Demo ini memberikan fleksibilitas untuk mencoba perilaku ini pada kedua versi dalam
aplikasi demo kami dan memilih mana yang sesuai untuk Anda. Misalnya, Anda mungkin masih
perlu menggunakan MapView
dalam situasi saat Anda menggunakan library
pihak ketiga yang memperkirakan untuk berinteraksi dengan class tersebut.