Penyiapan Utilitas Maps SDK for Android

Pilih platform: Android iOS

Halaman ini menjelaskan cara menyiapkan library utilitas Maps SDK for Android, dan menjalankan aplikasi demo yang disertakan dalam library.

Prasyarat dan catatan

Library utilitas Maps SDK for Android mendukung API level 15 dan versi yang lebih tinggi. Saat menetapkan target pembuatan project, pastikan Anda menggunakan API level Android terbaru.

Dokumentasi referensi tersedia di GitHub.

Langkah 1. Instal library utilitas Maps SDK for Android

Tambahkan dependensi berikut ke file build.gradle aplikasi Anda:

dependencies {
    implementation 'com.google.maps.android:android-maps-utils:2.3.0'

}

Gunakan salah satu utilitas dari library, seperti pengelompokan penanda, peta panas, atau utilitas lainnya.

Langkah 2. (Opsional) Instal library KTX utilitas Maps SDK for Android

Library utilitas Maps SDK for Android dilengkapi dengan library ekstensi Kotlin (KTX) yang sesuai. Library ini menyediakan fitur bahasa Kotlin—seperti fungsi ekstensi, argumen bernama dan default—untuk memungkinkan Anda menulis Kotlin yang ringkas dan idiomatis. Langkah ini dapat dilewati jika Anda tidak melakukan pengembangan di Kotlin.

Untuk menggunakan library ini, selain dependensi android-maps-utils, tambahkan dependensi berikut ke file build.gradle aplikasi Anda:

dependencies {
    implementation 'com.google.maps.android:maps-utils-ktx:3.4.0'
}

Lihat halaman Maps KTX GitHub untuk mendapatkan informasi tambahan tentang library ini.

Langkah 3. Lihat kode sumber library utilitas Maps SDK for Android

Karena library utilitas adalah open source, Anda dapat mendownload library android-maps-utils ke komputer Anda untuk menyesuaikannya, melihat aplikasi demo, atau untuk sekadar memahami cara kerja library tersebut. Anda dapat melakukannya dengan meng-clone repo (direkomendasikan, untuk menerima update otomatis) atau mendownload file zip. Jika ingin menyesuaikan library, Anda harus mem-fork repo.

Repositori ini menyertakan:

  • Aplikasi demo, dalam direktori demo.
  • Library utilitas, dalam direktori library.
  • Library utilitas untuk Maps SDK untuk v3 versi BETA, dalam direktori library-v3.
  • Berbagai file berisi informasi lisensi, kontributor, dan readme.
  • Konfigurasi build Gradle, untuk digunakan bersama Android Studio.

Menjalankan aplikasi demo utilitas

Repositori GitHub untuk library utilitas dikirimkan dengan aplikasi demo yang menyertakan contoh penerapan dari masing-masing utilitas. Ikuti langkah-langkah ini untuk menjalankan aplikasi demo pada perangkat Android Anda.

  1. Download repositori menggunakan salah satu opsi yang disebutkan di atas.
  2. Di Android Studio, pilih File -> New -> Import Project.
  3. Cari dan pilih (klik dua kali) direktori android-maps-utils yang dibuat saat Anda meng-clone library utilitas. Android Studio kini mulai membuat project.
  4. Jika Anda menggunakan perangkat Android, dan bukan emulator, pastikan untuk mengaktifkan mode developer. Kemudian, hubungkan perangkat Android ke komputer Anda.
  5. Tambahkan satu baris ke local.properties yang terlihat seperti ini:

    MAPS_API_KEY=YOUR_API_KEY

    Dengan YOUR_API_KEY adalah kunci API yang Anda peroleh seperti yang dijelaskan dalam Menggunakan Kunci API.

  6. Build dan jalankan aplikasi demo.

Aplikasi akan terbuka pada perangkat Android, menampilkan daftar utilitas yang meliputi pengelompokan, polyutil, peta panas, dan yang lainnya. Anda juga dapat menemukan aplikasi tersebut di daftar aplikasi, dengan nama Maps Utils Demo.