Haritalar Android Kotlin uzantıları (KTX), Android için Haritalar SDK'sı ve Android Utility Library için Haritalar SDK'sı için Kotlin uzantıları koleksiyonudur. Bu uzantılar, Android için Haritalar SDK'sı için geliştirme yaparken Kotlin diliyle ilgili özellikler sunarak kısa ve deyimsel Kotlin yazmanıza olanak tanır. Maps KTX, açık kaynaklı olup GitHub'da örneklerle birlikte kullanılabilir.
Döşeme
Android için Haritalar SDK'sı için KTX'i ve isteğe bağlı olarak Android Utility Library için Haritalar SDK'sını yüklemek amacıyla 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.0.0' }
Örnek Kullanımlar
KTX kitaplığıyla uzantı işlevleri, adlandırılmış parametreler ve varsayılan bağımsız değişkenler, yapılandırma bildirimleri ve eş yordamlar gibi çeşitli Kotlin dili özelliklerinden yararlanabilirsiniz.
Eş yordamları kullanarak Google Haritası alma
GoogleMap
'e 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 ekleme işlemi, addMarker()
DSL stili kullanılarak yapılabilir.
val sydney = LatLng(-33.852, 151.211) val marker = googleMap.addMarker { position(sydney) title("Marker in Sydney") }
Kamera olayları toplanıyor
Kamera hareketleri gibi olaylar Kotlin Flow ile toplanabilir.
lifecycleScope.launch { lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) { googleMap.cameraMoveEvents().collect { print("Received camera move event") } } }
Referans belgeleri okuyarak desteklenen özelliklerin tam listesini görebilirsiniz.
Örnek uygulamayı deneyin
Bu kitaplığın GitHub deposu, Haritalar KTX kitaplığını kendi uygulamanızda nasıl kullanabileceğinizi gösteren bir demo uygulaması da içerir.
Demo uygulamasını denemek için şu adımları izleyin:
- 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 bir API anahtarı ekleyin.
- Android için Haritalar SDK'sı anahtarı edinin.
- Kök dizinde
secrets.properties
adında 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"
alanına ekleyin. BuradaYOUR_API_KEY
, ilk adımda elde ettiğiniz gerçek API anahtarıdır. Örnek olaraksecrets.defaults.properties
'nı inceleyebilirsiniz. - Çalıştır yapılandırmasının altında app-ktx modülünü seçin.
- 'app-ktx' uygulamasını çalıştır'ı seçin.
Sırada ne var?
Google Haritalar Platformu için diğer Kotlin uzantı kitaplıkları da ilginizi çekebilir: