Haritalar Android KTX

Haritalar Android Kotlin uzantıları (KTX), Google Haritalar SDK'sı için Kotlin uzantılarından oluşan bir koleksiyondur. Android ve Android Yardımcı Programı Kitaplığı için Haritalar SDK'sı. Bu uzantılar Kısa ve deyimsel Kotlin yazmanıza olanak tanıyan Kotlin dili özellikleri . Maps KTX açık kaynaklıdır ve GitHub'da örnekler.

Kurulum

Android için Haritalar SDK'sı için KTX'i ve isteğe bağlı olarak Android Utility Library, build.gradle.kts dosyanıza aşağıdaki bağımlılıkları ekleyin dosyası olarak kaydedebilirsiniz.

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 pek çok Kotlin dilinden yararlanabilirsiniz. uzantı işlevleri, adlandırılmış parametreler ve varsayılan bağımsız değişkenler gibi özellikleri beyanları ve eş yordamları yıkmaktır.

Eş yordamları kullanarak GoogleHarita alma

GoogleMap erişimi alınabilir eş yordamları kullanıyor.

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 şurada görebilirsiniz: referans belgeleri.

Örnek uygulamayı deneyin

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

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ç'ı tıklayın ve dizine gidin ve 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
      kampanyasına ekleyin
      MAPS_API_KEY="YOUR_API_KEY"
      Burada YOUR_API_KEY, birinci adımda elde ettiğiniz gerçek API anahtarıdır. Daha fazla bilgi için secrets.defaults.properties açıklayacağım.
  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 için diğer Kotlin uzantı kitaplıkları da ilginizi çekebilir Platform:

  • Harita SDK'sı için KTX Android Yardımcı Program Kitaplığı
  • Yerler SDK'sı için KTX Android için