Haritalar Android KTX

Haritalar Android Kotlin uzantıları (KTX), Android için Haritalar SDK'sı ve Android Utility Library için Haritalar SDK'sına yönelik bir Kotlin uzantıları koleksiyonudur. Bu uzantılar, Android için Haritalar SDK'sı için geliştirme yaparken kısa ve deyimsel Kotlin yazmanıza olanak tanıyan Kotlin dili özellikleri sunar. Maps KTX açık kaynaktır ve örneklerle birlikte GitHub'da mevcuttur.

Döşeme

Android için Haritalar SDK'sı ve isteğe bağlı olarak Android Utility Library için Haritalar SDK'sı amacıyla KTX'i yüklemek üzere build.gradle 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.0.0'
}

Örnek Kullanımlar

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

Eş yordamları kullanarak GoogleHarita alma

Bir GoogleMap'a erişim, 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, DSL stili addMarker() yöntemi kullanılarak yapılabilir.

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

Kamera etkinlikleri toplanıyor

Kamera hareketleri gibi etkinlikler, Kotlin Akışı 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 deposu, Maps KTX kitaplığını kendi uygulamanızda nasıl kullanabileceğinizi gösteren bir demo uygulaması da içerir.

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

1. GitHub'dan ZIP dosyasını klonlayın veya indirin.
2. Android Studio'da Dosya -> Aç'ı seçin ve dizine gidip az önce klonladığınız veya indirdiğiniz klasörü açın.
3. Demo uygulamaya API anahtarı ekleyin.
1. Android için Haritalar SDK'sı anahtarı edinin.
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. Bu tek satırı secrets.properties
   

   MAPS_API_KEY="YOUR_API_KEY"

   öğesine ekleyin. Burada YOUR_API_KEY, ilk adımda elde ettiğiniz gerçek API anahtarıdır. Örnek olarak secrets.defaults.properties inceleyebilirsiniz.
4. Çalıştırma yapılandırması altında app-ktx modülünü seçin.
5. "app-ktx" komutunu çalıştır'ı seçin.

Sırada ne var?

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

• Android Utility Library için Harita SDK'sı KTX
• Android için Yerler SDK'sı için KTX