Coba demo

Dengan mengintegrasikan Navigation SDK untuk Android, aplikasi Anda dapat lebih dari sekadar menautkan ke tampilan peta eksternal. Dengan navigasi Google Maps, aplikasi Anda dapat menawarkan pengambilan data secara dinamis dan pelaporan data sekali pakai tentang perjalanan pengemudi.

Panduan ini menyajikan project Android Studio, menunjukkan cara mengintegrasikan Navigation SDK, lalu menunjukkan cara menjalankan aplikasi demo.

Navigation SDK adalah library statis yang memberi Anda kontrol atas tampilan dan audio untuk navigasi di aplikasi. Untuk mengetahui detail tentang library ini, buka Referensi Navigation SDK (Javadoc) di jendela terpisah.

Bersiaplah

Penting: Mulai Navigation SDK untuk Android v3.0, Anda bisa mendapatkan Navigation SDK versi terbaru untuk Android dari repositori Maven kami. Sekarang, ini adalah metode yang direkomendasikan untuk mendapatkan SDK. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan project.

Catatan: Akses ke Navigation SDK dikontrol melalui grup ruang kerja. Untuk mengetahui informasi selengkapnya, lihat Mendapatkan Akses.

Untuk mulai menggunakan Navigation SDK, pastikan Anda memiliki item berikut.

• Perwakilan Google Maps Platform untuk akses ke hal-hal berikut:

  • Kunci API yang disediakan untuk digunakan dengan Navigation SDK. Anda harus memasukkan projectID yang dapat Anda temukan di dasbor utama Konsol Google Cloud, di bagian nama project.
  • Artefak SDK. Pastikan project Anda dikonfigurasi agar dapat menggunakan Maven untuk Navigation SDK.
  • Untuk project yang menggunakan v4.99.0 dan versi sebelumnya. Jika tidak dapat menggunakan Maven, Anda dapat mendownload artefak yang telah 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 mem-build aplikasi dengan Navigation SDK.

Dokumentasi ini didesain untuk orang yang memahami konsep pengembangan Android dan pemrograman berorientasi objek. Anda juga harus memahami Google Maps dari sudut pandang pengguna.

Dapatkan aplikasi demo

Google menyediakan dua aplikasi untuk membantu Anda memahami apa yang ditawarkan Navigation SDK selain Google Maps API, bergantung pada tingkat pengalaman Anda. Developer yang sudah familier dengan Google Maps API dapat memfokuskan perhatian mereka pada demo GoogleNavigation. Bagi developer yang baru mengenal kedua project tersebut, kedua aplikasi tersebut akan berguna.

Mulai Navigation SDK untuk Android v4.1, aplikasi demo berikut tersedia di Google Drive bersama untuk didownload.

• Demo GoogleNavigation: Menunjukkan integrasi perilaku dan tampilan API karena berkaitan dengan pengalaman pengguna saat dalam sesi navigasi terpandu.

• Demo GoogleMap: menampilkan perilaku setiap 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.

Catatan: Untuk versi 4.99.0 dan yang lebih lama, jika masih ingin menggunakan paket AAR mentah dalam project, Anda dapat menambahkannya ke project di direktori libs. Kemudian, Anda harus menghapus semua referensi ke plugin artifactregistry dan repositori jarak jauh masing-masing, dan mendeklarasikan dependensi AAR berikut di build.gradle level aplikasi: api(name: 'google_navigation', ext: 'aar')

Demo GoogleNavigation

Demo GoogleNavigation terbaru tersedia di root Google Drive bersama. Versi aplikasi sebelumnya ada di "Arsip." Untuk versi sebelum 4.1, aplikasi dipaketkan bersama AAR dalam file ZIP yang sama.

Gedung

1. Di Android Studio, impor aplikasi demo dan izinkan Gradle berjalan.

   Catatan: Aplikasi akan gagal memuat peta sampai Anda memperbarui local.defaults.properties dengan kunci API yang disediakan.

2. Buka local.defaults.properties dan perbarui nilai properti MAPS_API_KEY:

     MAPS_API_KEY=YOUR_API_KEY
   

3. Klik build dan periksa detail penerapan SDK.

   • Di class Java, catat kode implementasinya.

   • Dalam XML tata letak, perhatikan teks dan desain tata letak.

   • Dalam file build.gradle, catat SDK dalam dependensi.

Lihat dokumentasi plugin Gradle Secrets untuk informasi selengkapnya tentang cara kunci API ditambahkan ke manifes.

Berjalan

1. Hubungkan perangkat Android ke komputer Anda atau gunakan emulator.

   • Perangkat Android—Lihat instructions untuk mengaktifkan opsi developer di perangkat Android Anda dan mengonfigurasi sistem untuk mendeteksi perangkat tersebut.
   • Emulatormdash;Gunakan AVD Manager untuk mengonfigurasi perangkat virtual. Saat memilih emulator, pastikan Anda memilih image yang berisi Google API.

2. Di Android Studio, klik opsi menu Run (atau ikon tombol putar); lalu pilih target deployment.

Saat dibuat dan diluncurkan, aplikasi akan menampilkan halaman landing yang berisi daftar opsi kepada pengguna.

Opsi NavViewActivity dan NavFragmentActivity

Pengguna baru NavSDK mungkin 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 informasi berikut:

• UI navigasi
• tombol "Tetapkan Tujuan" di menu aplikasi
• overlay yang bisa berinteraksi dengan Anda untuk memanggil metode secara dinamis pada API
• menu tambahan dengan lebih banyak opsi

Untuk memulai, klik Tetapkan Tujuan dan pilih alamat. Aplikasi kemudian menyimulasikan perjalanan dari lokasi Anda saat ini ke alamat tersebut. Gunakan overlay panel kontrol untuk melihat apa yang terjadi jika Anda memanggil API. Misalnya, Anda dapat mengklik View Methods untuk mencoba memaksa SDK beralih ke mode malam guna melihat tampilannya.

Opsi SwappingMapAndNavActivity

Catatan: Opsi ini membantu Anda bertransisi dari v1 ke v4. Kami menyarankan penggunaan NavigationView secara eksklusif jika memungkinkan, tetapi memberikan hal ini sebagai contoh cara menggunakan keduanya secara berdampingan.

SwappingMapAndNavActivity menampilkan pola umum berikut:

• menampilkan MapView
• beralih ke NavigationView saat navigasi dimulai
• kembali ke MapView saat navigasi berakhir

Demo GoogleMap

Catatan: Aplikasi ini tidak tersedia untuk versi SDK sebelum v4.1.

Demo GoogleNavigation terbaru tersedia di root Google Drive bersama. Versi aplikasi sebelumnya ada di "Arsip."

Gedung

1. Di Android Studio, impor aplikasi demo dan izinkan Gradle berjalan.

   Catatan: Aplikasi akan gagal memuat peta hingga Anda memperbarui local.defaults.properties dengan kunci API yang disediakan.

2. Buka local.defaults.properties dan perbarui nilai properti MAPS_API_KEY:

     MAPS_API_KEY=YOUR_API_KEY
   

3. Klik build dan periksa detail penerapan SDK.

   • Di class Java, catat kode implementasinya.

   • Dalam XML tata letak, perhatikan teks dan desain tata letak.

   • Dalam file build.gradle, catat SDK dalam dependensi.

Lihat plugin gradle secret untuk informasi selengkapnya tentang cara kunci API ditambahkan ke Manifes.

Berjalan

1. 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 AVD Manager untuk mengonfigurasi perangkat virtual. Saat memilih emulator, pastikan Anda memilih image yang berisi Google API.

2. Di Android Studio, klik opsi menu Run (atau ikon tombol putar); lalu pilih target deployment.

Saat dibuat dan diluncurkan, aplikasi akan menampilkan 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 didesain agar mirip dengan aplikasi demo Maps API. Perbedaan utamanya adalah demo Navigation SDK memungkinkan pengguna memilih class tampilan yang ingin mereka uji dan menjalankan demo pada: NavigationView atau MapView, jika berlaku.

Google biasanya mendorong pengguna untuk menggunakan NavigationView. Demo ini memberikan fleksibilitas untuk mencoba perilaku ini pada kedua versi dalam aplikasi demo kami dan memilih mana yang paling cocok untuk Anda. Misalnya, Anda mungkin masih perlu menggunakan MapView jika Anda menggunakan library pihak ketiga yang diharapkan akan berinteraksi dengan class tersebut.

Penting: Class MapView, MapFragment dan SupportMapFragment mengharuskan perangkat telah menginstal aplikasi Layanan Google Play. Jika Anda menjalankan emulator baru, atau mereset perangkat lama ke setelan pabrik, image Android mungkin dilengkapi dengan Layanan Google Play yang sangat usang dan sudah terinstal sebelumnya. Dalam kasus seperti itu, Anda harus menunggu hingga aplikasi menarik versi yang lebih baru secara otomatis, atau mengupdate Layanan Play secara manual melalui Google Play Store.