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 örneklerle birlikte GitHub'da bulunabilir.

Kurulum

Android için Haritalar SDK'sı için KTX'i ve isteğe bağlı olarak Android Yardımcı Program Kitaplığı'na aşağıdaki bağımlılıkları ekleyin: build.gradle.kts 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.

İş parçacıklarını kullanarak Google haritası 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 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 Flow 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 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 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. Ö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 için diğer Kotlin uzantı kitaplıkları da ilginizi çekebilir Platform:

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