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.
- Download repositori menggunakan salah satu opsi yang disebutkan di atas.
- Di Android Studio, pilih File -> New -> Import Project.
- Cari dan pilih (klik dua kali) direktori android-maps-utils yang dibuat saat Anda meng-clone library utilitas. Android Studio kini mulai membuat project.
- Jika Anda menggunakan perangkat Android, dan bukan emulator, pastikan untuk mengaktifkan mode developer. Kemudian, hubungkan perangkat Android ke komputer Anda.
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.
- 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.