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:
- GitHub'dan ZIP dosyasını klonlayın veya indirin.
- Android Studio'da Dosya -> Aç'ı tıklayın ve dizine gidin ve az önce klonladığınız veya indirdiğiniz klasörü açın.
- Demo uygulamasına bir API anahtarı ekleyin.
- Android için Haritalar SDK'sı anahtarı edinin.
- 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. - Bu tek satırı
secrets.properties
kampanyasına ekleyinMAPS_API_KEY="YOUR_API_KEY"
BuradaYOUR_API_KEY
, birinci adımda elde ettiğiniz gerçek API anahtarıdır. Örneğin,secrets.defaults.properties
- Çalıştırma yapılandırması altında app-ktx modülünü seçin.
- "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: