Haritalar Android KTX

Android için Haritalar Kotlin uzantıları (KTX), Android için Haritalar SDK'sı ve Android için Haritalar SDK'sı Yardımcı Kitaplığı'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ı ve isteğe bağlı olarak Android için Haritalar SDK'sı Yardımcı Kitaplığı'na KTX'yi 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("com.google.maps.android:maps-ktx:5.2.0")
}

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.

GoogleMap'i eş yordamlar kullanarak 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 etkinliklerini 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 referans belgelerini okuyarak görebilirsiniz.

Örnek uygulamayı deneyin

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

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. API anahtarınızı korumak için bu dosya sürüm kontrolü 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