Coba demo

Dengan mengintegrasikan Navigation SDK for Android, aplikasi Anda dapat melakukan lebih dari sekadar menautkan ke tampilan peta eksternal. Dengan navigasi Google Maps, aplikasi Anda dapat menawarkan pengambilan dinamis dan pelaporan data sekali lihat tentang perjalanan pengguna. Panduan ini menjelaskan cara menjalankan aplikasi demo Navigation SDK, yang tersedia di GitHub.

Lakukan penyiapan

Untuk memulai Navigation SDK, pastikan Anda memiliki item berikut.

  • Kunci API yang disediakan untuk digunakan dengan Navigation SDK. Lihat Menggunakan Kunci API untuk mengetahui informasi selengkapnya tentang cara membuat dan membatasi kunci.
  • Artefak SDK. Pastikan project Anda dikonfigurasi untuk menggunakan Maven untuk Navigation SDK.
  • Satu atau beberapa aplikasi demo.
  • Android Studio, lingkungan pengembangan yang direkomendasikan untuk membuat aplikasi dengan Navigation SDK.

Dokumentasi ini ditujukan untuk orang yang memahami konsep pengembangan dan pemrograman berorientasi objek Android. 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 Google Maps API, bergantung pada tingkat pengalaman Anda. Developer yang memahami Google Maps API dapat memfokuskan perhatian mereka pada demo GoogleNavigation. Developer yang baru menggunakan kedua project ini akan merasa terbantu dengan kedua aplikasi tersebut.

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

  • Demo GoogleNavigation: Menampilkan integrasi perilaku API dan tampilan yang berkaitan dengan pengalaman pengguna saat berada dalam sesi navigasi terpandu.

  • Demo GoogleMap: menampilkan perilaku individual antarmuka GoogleMap untuk menyesuaikan tampilan dan presentasi peta.

Demo GoogleNavigation

Demo GoogleNavigation terbaru tersedia di GitHub.

Build

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

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

      MAPS_API_KEY=YOUR_API_KEY

  3. Klik build dan periksa detail penerapan SDK.

    • Di class Java, perhatikan kode implementasinya.

    • Di XML tata letak, perhatikan desain dan teks tata letaknya.

    • Di file build.gradle, perhatikan SDK dalam dependensi.

Lihat dokumentasi plugin Gradle Secret untuk mengetahui informasi selengkapnya tentang cara menambahkan kunci API ke manifes.

Jalankan

  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 agar mendeteksi perangkat.
    • Emulator—Gunakan Android Virtual Device (AVD) Manager untuk mengonfigurasi perangkat virtual. Saat memilih emulator, pastikan Anda memilih image yang menyertakan 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 berisi daftar opsi kepada pengguna.

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 dengan Navigator.

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

  • UI navigasi
  • tombol "Set Destination" di menu aplikasi
  • overlay yang dapat Anda gunakan untuk memanggil metode secara dinamis di API
  • menu overflow dengan opsi lainnya

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

Opsi SwappingMapAndNavActivity

SwappingMapAndNavActivity menampilkan pola umum berikut:

Demo GoogleMap

Demo GoogleNavigation terbaru tersedia di GitHub.

Build

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

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

      MAPS_API_KEY=YOUR_API_KEY

  3. Klik build dan periksa detail penerapan SDK.

    • Di class Java, perhatikan kode implementasinya.

    • Di XML tata letak, perhatikan desain dan teks tata letaknya.

    • Di file build.gradle, perhatikan SDK dalam dependensi.

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

Jalankan

  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 agar mendeteksi perangkat.
    • Emulator Gunakan Android Virtual Device (AVD) Manager untuk mengonfigurasi perangkat virtual. Saat memilih emulator, pastikan Anda memilih image yang menyertakan 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 berisi daftar demo kepada pengguna.

Pola presentasi ini dan struktur kode sumber yang sesuai harus dipahami oleh pengguna demo Google Maps SDK. Hal ini karena demo GoogleMap dirancang agar mirip dengan aplikasi demoMaps API. Perbedaan utamanya adalah demo Navigation SDK memungkinkan pengguna memilih class tampilan yang ingin mereka uji coba: NavigationView atau MapView, jika berlaku.

Google umumnya mendorong pengguna untuk menggunakan NavigationView. Demo ini memberikan fleksibilitas untuk mencoba perilaku ini di kedua versi dalam aplikasi demo kami dan memilih versi mana pun yang sesuai untuk Anda. Misalnya, Anda mungkin masih perlu menggunakan MapView dalam situasi saat Anda menggunakan library pihak ketiga yang diharapkan dapat berinteraksi dengan class tersebut.