Haritalar Android Kotlin uzantıları (KTX), Android için Haritalar SDK'sı ve Android Utility Library için Haritalar SDK'sına yönelik bir Kotlin uzantıları koleksiyonudur. Bu uzantılar, Android için Haritalar SDK'sı için geliştirme yaparken kısa ve deyimsel Kotlin yazmanıza olanak tanıyan Kotlin dili özellikleri sunar. Maps KTX açık kaynaktır ve örneklerle birlikte GitHub'da mevcuttur.
Döşeme
Android için Haritalar SDK'sı ve isteğe bağlı olarak Android Utility Library için Haritalar SDK'sı amacıyla KTX'i yüklemek üzere 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.1.1' }
Örnek Kullanımlar
KTX kitaplığıyla uzantı işlevleri, adlandırılmış parametreler ve varsayılan bağımsız değişkenler, beyanların yapılandırılması ve eş yordamlar gibi çeşitli Kotlin dili özelliklerinden yararlanabilirsiniz.
Eş yordamları kullanarak GoogleHarita alma
Bir GoogleMap
'a 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 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 referans belgelerini okuyarak görebilirsiniz.
Örnek uygulamayı deneyin
Bu kitaplığın GitHub deposu, Maps KTX kitaplığını kendi uygulamanızda nasıl kullanabileceğinizi gösteren bir demo uygulaması da içerir.
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ç'ı seçin ve dizine gidip 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
MAPS_API_KEY="YOUR_API_KEY"
öğesine ekleyin. BuradaYOUR_API_KEY
, ilk adımda elde ettiğiniz gerçek API anahtarıdır. Örnek olaraksecrets.defaults.properties
inceleyebilirsiniz. - Ç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 Platformu için diğer Kotlin uzantı kitaplıkları da ilginizi çekebilir: