Haritalar Android KTX

Android için Haritalar Kotlin uzantıları (KTX), Android için Haritalar SDK'sı ve Android için Haritalar 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 yerel Kotlin yazmanızı sağlayan Kotlin dil özellikleri sağlar. Haritalar KTX, açık kaynaklıdır ve örneklerle birlikte GitHub'da bulunabilir.

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.1.1")
}

Örnek Kullanımlar

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

İş parçacıklarını kullanarak Google haritası alma

GoogleMap'a erişmek için coroutine'ler kullanılabilir.

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

İşaret ekleme

İşaretçi eklemek için DSL stilinde addMarker() yöntemi 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")
    }
  }
}

Referans dokümanlarını okuyarak desteklenen özelliklerin tam listesini görebilirsiniz.

Ö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 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ı edinin.
2. Kök dizininde secrets.properties adlı bir dosya oluşturun. API anahtarınızı korumak için bu dosya sürüm denetimi altında OLMAMALIDIR.
3. Bu tek satırı secrets.properties
   dosyasına ekleyin.

   MAPS_API_KEY="YOUR_API_KEY"

   Burada YOUR_API_KEY, ilk adımda aldığınız gerçek API anahtarıdır. Örneğin, secrets.defaults.properties
4. Çalıştırma yapılandırması altında app-ktx modülünü seçin.
5. "app-ktx" dosyasını çalıştır'ı seçin.

Sırada ne var?

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

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