Coba demo

Dengan mengintegrasikan Navigation SDK untuk Android, aplikasi Anda tidak hanya dapat ditautkan ke tampilan peta eksternal. Dengan navigasi Google Maps, aplikasi Anda dapat menawarkan pengambilan dan pelaporan data satu tampilan tentang {i>user journey<i}. 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 Anda temukan di dasbor utama Konsol Google Cloud, di bawah nama proyek.
    • 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 file .aar 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 familier dengan Google Peta dari sudut pandang pengguna.

Mendapatkan aplikasi demo

Google menyediakan dua aplikasi untuk membantu Anda memahami Navigation SDK selain Google Maps API, bergantung pada tingkat pengalaman Anda. Developer yang familier dengan Google Maps API dapat memfokuskan perhatian mereka pada demo GoogleNavigation. Developer yang baru menggunakan proyek akan menggunakan kedua aplikasi tersebut.

Mulai Navigation SDK for Android v4.1, aplikasi demo berikut keduanya yang tersedia di GitHub untuk didownload.

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

  • Demo GoogleMap: menunjukkan perilaku individual GoogleMap untuk menyesuaikan nuansa dan penyajian peta.

Catatan tentang penggunaan Maven

Aplikasi demo dikonfigurasi untuk mendownload artefak SDK dari Maven jarak jauh repositori Anda, 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

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

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

      MAPS_API_KEY=YOUR_API_KEY
    
  3. 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 Secrets Gradle plugin dokumentasi untuk informasi selengkapnya tentang cara menambahkan kunci API ke manifes.

Berjalan

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

    • Perangkat Android—Lihat petunjuk untuk mengaktifkan opsi developer di perangkat Android dan mengonfigurasi sistem Anda untuk mendeteksi perangkat.
    • Emulatormdash;Gunakan Android Virtual Device (AVD) Pengelola untuk melakukan konfigurasi perangkat virtual. Saat memilih emulator, pastikan Anda pilih image yang berisi Google API.
  2. Di Android Studio, klik opsi menu Run (atau tombol putar icon); lalu pilih target deployment.

Saat dibuat dan diluncurkan, aplikasi menyajikan kepada pengguna halaman landing yang berisi daftar pilihan.

Pengguna baru NavSDK mungkin akan menganggap kedua opsi ini sebagai opsi yang paling berguna.

Opsi 1: NavViewActivity menampilkan perilaku menggunakan NavigationView bersama dengan Navigator.

Opsi 2: Opsi kedua, berjudul NavFragmentActivity, menampilkan perilaku peserta menggunakan SupportNavigationFragment bersama dengan Navigator.

Saat Anda mengklik salah satu opsi ini, Anda akan melihat hal berikut:

  • UI navigasi
  • "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. Menggunakan kontrol panel overlay untuk melihat apa yang terjadi ketika Anda memanggil API. Misalnya, Anda dapat klik View Methods untuk mencoba memaksa SDK masuk ke mode malam untuk melihat apa yang dimaksud itu.

Opsi SwappingMapAndNavActivity

SwappingMapAndNavActivity menampilkan pola umum berikut:

Demo GoogleMap

Demo GoogleNavigation terbaru tersedia di GitHub.

Gedung

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

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

      MAPS_API_KEY=YOUR_API_KEY
    
  3. 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 gradle secrets plugin untuk mendapatkan informasi selengkapnya tentang cara menambahkan kunci API ke Manifes.

Berjalan

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

    • Perangkat Android Lihat petunjuk untuk mengaktifkan opsi developer di perangkat Android Anda dan mengonfigurasi sistem untuk mendeteksi perangkat.
    • Emulator Menggunakan Android Virtual Device (AVD) Pengelola untuk mengkonfigurasi perangkat virtual. Saat memilih emulator, pastikan Anda pilih image yang berisi Google API.
  2. Di Android Studio, klik opsi menu Run (atau tombol putar icon); lalu pilih target deployment.

Saat dibuat dan diluncurkan, aplikasi menyajikan kepada pengguna halaman landing yang berisi daftar demo.

Pola presentasi ini dan struktur kode sumber yang sesuai harus familier bagi pengguna demo Google Maps SDK. Hal ini karena Demo GoogleMap dirancang agar serupa dengan demo Maps API aplikasi. Utama perbedaannya adalah demo Navigation SDK memungkinkan pengguna memilih class tampilan mereka ingin menguji dan menjalankan demo: NavigationView atau MapView, jika perlu.

Google umumnya mendorong pengguna untuk menggunakan NavigationView Demo ini memberikan fleksibilitas untuk mencoba perilaku ini pada kedua versi dalam aplikasi demo kami dan pilih mana yang sesuai untuk Anda. Misalnya, mungkin masih yang diperlukan untuk menggunakan MapView dalam situasi saat Anda menggunakan library yang mengharapkan interaksi dengan class tersebut.