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
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:
- 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 uygulamaya API anahtarı ekleyin.
- Android için Haritalar SDK'sı anahtarı edinin.
- 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. - 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. Daha fazla bilgi içinsecrets.defaults.properties
açıklayacağım. - Çalıştırma yapılandırması altında app-ktx modülünü seçin.
- "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: