Mulai

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 menunjukkan project Android Studio, cara mengintegrasikan Navigation SDK, dan menjalankan aplikasi demo yang disediakan dengan SDK tersebut.

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

Bersiaplah

Untuk mulai menggunakan Navigation SDK for Android, pastikan untuk 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.

    • File zip yang berisi:

      • File library statis .aar di direktori libs/ yang berisi Navigation SDK sebagai paket aar.
      • File teks untuk pemberian lisensi dan link ke Persyaratan Penggunaan dan perjanjian.
      • Aplikasi demo yang akan diimpor sebagai project baru di Android Studio. File aplikasi untuk mem-build aplikasi demo di Android Studio menggunakan Gradle dan Maven.

  • Android Studio, lingkungan pengembangan yang direkomendasikan untuk mem-build aplikasi dengan Navigation SDK. Dokumentasi ini didesain untuk orang yang memahami pengembangan Android dan konsep pemrograman berorientasi objek. Anda juga harus mengenal Google Maps dari sudut pandang pengguna.

Dapatkan SDK, aplikasi demo, dan dokumentasi

Setelah mendownload dan mengekstrak file SDK, Anda dapat memeriksa dan menjalankan aplikasi demo.

Aplikasi demo menyediakan build yang mengimplementasikan class NavigationFragment dan varian yang mengimplementasikan class NavigationView. Varian NavigationFragment berjalan secara default dan menampilkan jalur navigasi seperti yang ditunjukkan pada gambar berikut.

  1. Dengan menggunakan file manager favorit Anda, buka direktori yang berisi file SDK.

  2. Salin library Navigation SDK ke direktori app/libs dari project demo:

    Misalnya, Anda dapat menjalankan cp libs/*.aar demo/app/libs di terminal Linux.

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

  4. Buka AndroidManifest.xml aplikasi dan perbarui nilai properti API_KEY:

    <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.navigationapidemo" >

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/_AppTheme" >

        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="YOUR_API_KEY"/>
    </application>
</manifest>

  5. Klik build dan periksa detail penerapan SDK.

    • Di class java, catat kode penerapan.

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

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

Menjalankan aplikasi

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

    • Perangkat Android Lihat instructions untuk mengaktifkan opsi developer di perangkat Android dan mengonfigurasi sistem untuk 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.

  3. Di aplikasi Demo Navigasi, pilih Tetapkan Tujuan, lalu ikuti petunjuk untuk memilih lokasi dan memulai simulasi navigasi.

Mem-build Varian Tampilan

Aplikasi demo menyertakan varian Tampilan.

  1. Di Android Studio, buka aplikasi demo dan klik tab Build Variants di jendela Build.

  2. Di jendela Build Variants, pilih viewDebug dan daftar file akan berubah.

  3. Periksa detail penerapan SDK untuk class NavigationView.

    • Di NavViewActivity.java, catat kode penerapan.

    • Di Activity_Nav_View.xml, perhatikan teks dan desain tata letak.

  4. Build dan jalankan aplikasi. Nama aplikasi berubah untuk menunjukkan versi yang dibuat. Jika tidak, hanya objek rendering yang berbeda.

Langkah berikutnya

Integrasikan Navigation SDK untuk Android ke dalam aplikasi Anda sendiri.