Haritalar Android KTX

Haritalar Android Kotlin uzantıları (KTX), Android için Haritalar SDK'sı ve Android Utility Library için Haritalar SDK'sı için Kotlin uzantıları koleksiyonudur. Bu uzantılar, Android için Haritalar SDK'sı için geliştirme yaparken Kotlin diliyle ilgili özellikler sunarak kısa ve deyimsel Kotlin yazmanıza olanak tanır. Maps KTX, açık kaynaklı olup GitHub'da örneklerle birlikte kullanılabilir.

Döşeme

Android için Haritalar SDK'sı için KTX'i ve isteğe bağlı olarak Android Utility Library için Haritalar SDK'sını yüklemek amacıyla 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, yapılandırma bildirimleri ve eş yordamlar gibi çeşitli Kotlin dili özelliklerinden yararlanabilirsiniz.

Eş yordamları kullanarak Google Haritası alma

GoogleMap'e 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 ekleme işlemi, addMarker() DSL stili kullanılarak yapılabilir.

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

Kamera olayları toplanıyor

Kamera hareketleri gibi olaylar Kotlin Flow ile toplanabilir.

lifecycleScope.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    googleMap.cameraMoveEvents().collect {
      print("Received camera move event")
    }
  }
}

Referans belgeleri okuyarak desteklenen özelliklerin tam listesini görebilirsiniz.

Örnek uygulamayı deneyin

Bu kitaplığın GitHub deposu, Haritalar KTX kitaplığını kendi uygulamanızda nasıl kullanabileceğinizi gösteren bir demo uygulaması da içerir.

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

  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 bir API anahtarı ekleyin.
    1. Android için Haritalar SDK'sı anahtarı edinin.
    2. Kök dizinde secrets.properties adında 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"
      alanına ekleyin. Burada YOUR_API_KEY, ilk adımda elde ettiğiniz gerçek API anahtarıdır. Örnek olarak secrets.defaults.properties'nı inceleyebilirsiniz.
  4. Çalıştır yapılandırmasının altında app-ktx modülünü seçin.
  5. 'app-ktx' uygulamasını ç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 Harita SDK'sı için KTX
  • Android'de Yerler SDK'sı için KTX