Haritalar Android KTX

Haritalar Android Kotlin uzantıları (KTX), Android için Haritalar SDK'sı ve Android için Haritalar SDK Yardımcı Program Kitaplığı için 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 için Haritalar SDK'sı Yardımcı Kitaplığı'na KTX'i yüklemek için 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, uzantı işlevleri, adlandırılmış parametreler ve varsayılan bağımsız değişkenler, yapı bozma bildirimleri ve coroutine'ler gibi çeşitli Kotlin dili özelliklerinden yararlanabilirsiniz.

Eş yordamları kullanarak Google Haritası 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()
  }
}

İşaretleyici 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 okuyabilirsiniz.

Örnek uygulamayı deneyin

Bu kütüphanenin GitHub deposunda, Maps KTX kütüphanesini kendi uygulamanızda nasıl kullanabileceğinizi gösteren bir demo uygulaması da bulunmaktadır.

Demo uygulamasını denemek için şu adımları izleyin:

  1. GitHub'dan kopyalayın veya ZIP dosyasını indirin.
  2. Android Studio'da Dosya -> Aç'ı seçin ve dizine gidip 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. API anahtarınızı korumak için bu dosya 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 Utility Library için Haritalar SDK'sında KTX
  • Android için Yerler SDK'sı için KTX