Penyiapan Utilitas Maps SDK for Android

Pilih platform: Android iOS

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

Prasyarat dan catatan

Library aplikasi 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 aplikasi utilitas Maps SDK for Android

Tambahkan dependensi berikut ke file build.gradle aplikasi Anda:

dependencies {


    // Utility Library for Maps SDK for Android
    // You do not need to add a separate dependency for the Maps SDK for Android
    // since this library builds in the compatible version of the Maps SDK.
    implementation 'com.google.maps.android:android-maps-utils:3.8.0'
}

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

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

Library aplikasi 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 {

    // KTX for the Maps SDK for Android Utility Library
    implementation 'com.google.maps.android:maps-utils-ktx:5.1.1'
}

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

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

Karena library aplikasi 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.
  • Berbagai file berisi informasi lisensi, kontributor, dan readme.
  • Konfigurasi build Gradle, untuk digunakan bersama Android Studio.

Menjalankan aplikasi demo utilitas

Repositori GitHub untuk library aplikasi 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 aplikasi 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 pembuatan cluster, polyutil, peta panas, dan yang lainnya. Anda juga dapat menemukan aplikasi tersebut di daftar aplikasi, dengan nama Maps Utils Demo.