Android KTX Maps

Ekstensi Android Kotlin (KTX) Maps adalah kumpulan ekstensi Kotlin untuk Maps SDK for Android dan Library Utilitas Maps SDK for Android. Ekstensi ini menyediakan fitur bahasa Kotlin yang memungkinkan Anda menulis bahasa Kotlin yang ringkas dan idiomatis saat melakukan pengembangan menggunakan Maps SDK for Android. KTX Maps bersifat open source dan tersedia di GitHub bersama dengan contohnya.

Penginstalan

Agar dapat menginstal KTX untuk Maps SDK for Android, dan secara opsional untuk Library Utilitas Maps SDK for Android, tambahkan dependensi berikut ke file build.gradle Anda.

dependencies {

    // KTX for the Maps SDK for Android library
    implementation 'com.google.maps.android:maps-ktx:5.0.0'
}

Contoh Penggunaan

Dengan library KTX, Anda dapat memanfaatkan beberapa fitur bahasa Kotlin seperti fungsi ekstensi, parameter bernama dan argumen default, deklarasi destrukturisasi, serta coroutine.

Mengambil GoogleMap menggunakan coroutine

Akses GoogleMap dapat diambil menggunakan coroutine.

lifecycleScope.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    val mapFragment: SupportMapFragment? =
      supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
    val googleMap: GoogleMap? = mapFragment?.awaitMap()
  }
}

Menambahkan penanda

Penanda dapat ditambahkan menggunakan metode gaya DSL addMarker().

val sydney = LatLng(-33.852, 151.211)
val marker = googleMap.addMarker {
  position(sydney)
  title("Marker in Sydney")
}

Mengumpulkan peristiwa kamera

Peristiwa, seperti gerakan kamera, dapat dikumpulkan melalui Alur Kotlin.

lifecycleScope.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    googleMap.cameraMoveEvents().collect {
      print("Received camera move event")
    }
  }
}

Anda dapat melihat daftar lengkap fitur yang didukung dengan membaca dokumentasi referensi.

Mencoba contoh aplikasi

Repositori GitHub untuk library ini juga berisi aplikasi demo yang menunjukkan cara penggunaan library KTX Maps dalam aplikasi Anda.

Untuk mencoba aplikasi demo, ikuti langkah-langkah berikut:

  1. Dari GitHub, clone atau download file ZIP.
  2. Di Android Studio, pilih File -> Open dan buka direktori, lalu buka folder yang baru saja Anda clone atau download.
  3. Tambahkan kunci API ke aplikasi demo.
    1. Dapatkan kunci Maps SDK for Android.
    2. Di direktori root, buat file bernama secrets.properties. File ini TIDAK boleh berada dalam kontrol versi untuk melindungi kunci API.
    3. Tambahkan satu baris ini ke secrets.properties
      MAPS_API_KEY="YOUR_API_KEY"
      dengan YOUR_API_KEY adalah kunci API sebenarnya yang Anda peroleh di langkah pertama. Anda dapat melihat secrets.defaults.properties sebagai contoh.
  4. Di bagian konfigurasi run, pilih modul app-ktx.
  5. Pilih Run 'app-ktx'.

Langkah berikutnya

Anda mungkin juga tertarik dengan library ekstensi Kotlin lainnya untuk Google Maps Platform:

  • KTX untuk Library Utilitas Maps SDK for Android
  • KTX untuk Places SDK for Android