Haritalar Android KTX

Android için Haritalar Kotlin uzantıları (KTX), Android için Haritalar SDK'sı ve Android Yardımcı Program Kitaplığı İçin Haritalar SDK'sı'na yönelik bir Kotlin uzantıları koleksiyonudur. Bu uzantılar, Android için Haritalar SDK'sında geliştirme yaparken kısa ve deyimsel Kotlin kodu yazmanızı sağlayan Kotlin dil özelliklerini sunar. Maps KTX açık kaynaklıdır ve örneklerle birlikte GitHub'da mevcuttur.

Kurulum

Android için Haritalar SDK'sına ve isteğe bağlı olarak Android Yardımcı Program Kitaplığı için Haritalar SDK'sına KTX'i yüklemek üzere build.gradle.kts dosyanıza aşağıdaki bağımlılıkları ekleyin.

dependencies {

    // KTX for the Maps SDK for Android library
    implementation(libs.maps.ktx)
}

Kullanım örnekleri

KTX kitaplığıyla, Kotlin dilinin uzantı işlevleri, adlandırılmış parametreler ve varsayılan bağımsız değişkenler, yapı bozma bildirimleri ve eş yordamlar gibi çeşitli özelliklerinden yararlanabilirsiniz.

Coroutine'ları kullanarak GoogleMap alma

GoogleMap erişimi, eş yordamlar kullanılarak alınabilir.

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

İşaretçi ekleme

İşaretçi eklemek için DSL tarzı yöntem addMarker() kullanılabilir.

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

Kamera olaylarını toplama

Kamera hareketleri gibi etkinlikler Kotlin Flow aracılığıyla toplanabilir.

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

Desteklenen özelliklerin tam listesini görmek için referans belgelerini inceleyebilirsiniz.

Örnek uygulamayı deneyin

Bu kitaplığın GitHub deposunda, Haritalar KTX kitaplığını kendi uygulamanızda nasıl kullanabileceğinizi gösteren bir demo uygulaması da bulunur.

Demo uygulamasını denemek için aşağıdaki adımları uygulayın:

  1. GitHub'dan kopyalayın veya ZIP dosyasını indirin.
  2. Android Studio'da File -> Open'ı (Dosya -> Aç) seçin, dizine gidin ve yeni klonladığınız veya indirdiğiniz klasörü açın.
  3. Demo uygulamasına bir API anahtarı ekleyin.
    1. Android için Haritalar SDK'sı anahtarı alın.
    2. Kök dizinde secrets.properties adlı bir dosya oluşturun. Bu dosya, API anahtarınızı korumak için sürüm denetimi altında OLMAMALIDIR.
    3. secrets.properties
      dosyasına şu tek satırı ekleyin: 
      MAPS_API_KEY="YOUR_API_KEY"
       burada YOUR_API_KEY, ilk adımda aldığınız gerçek API anahtarıdır. Örnek olarak secrets.defaults.properties sayfasını inceleyebilirsiniz.
  4. Çalıştırma yapılandırması altında app-ktx modülünü seçin.
  5. Run 'app-ktx'. (app-ktx'i çalıştır) seçeneğini belirleyin.

Sırada ne var?

Google Haritalar Platformu için diğer Kotlin uzantı kitaplıkları da ilginizi çekebilir:

  • Android Yardımcı Program Kitaplığı İçin Haritalar SDK'sı KTX
  • Android için Yerler SDK'sı için KTX