Haritalar Android KTX

Haritalar Android Kotlin uzantıları (KTX), Android için Haritalar SDK'sı ve Android Yardımcı Program Kitaplığı İçin Haritalar SDK'sı için Kotlin uzantıları koleksiyonudur. Bu uzantılar, Android için Haritalar SDK'sı ile geliştirme yaparken kısa ve deyimsel Kotlin yazmanıza olanak tanıyan Kotlin dili özellikleri 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 {

    // Maps SDK for Android Utils library (includes KTX extensions)
    implementation(libs.android.maps.utils)
}

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 eş yordamlar gibi çeşitli Kotlin dili özelliklerinden yararlanabilirsiniz.

Eş yordamları kullanarak GoogleMap alma

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

scope.launch {
    if (context is FragmentActivity) {
        val mapFragment =
            context.supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
        val 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.

scope.launch {
    googleMap.cameraMoveEvents().collect {
        Log.d("KTX", "Received camera move event")
    }
}

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

Örnek uygulamayı deneme

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

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

  1. GitHub'dan ZIP dosyasını kopyalayın veya indirin.
  2. Android Studio'da File -> Open'ı (Dosya -> Aç) seçin, dizine gidin ve yeni kopyaladığı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'e bakabilirsiniz.
  4. Çalıştırma yapılandırması altında app-ktx modülünü seçin.
  5. Run 'app-ktx''i ('app-ktx'i çalıştır) seçin.

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ı için KTX
  • Android için Yerler SDK'sı KTX