تمثل إضافات خرائط Kotlin لنظام التشغيل Android (KTX) مجموعة من إضافات Kotlin لحزمة تطوير البرامج (SDK) للخرائط في نظام التشغيل Android وحزمة تطوير البرامج لخرائط Google لمكتبة أدوات Android. توفر هذه الإضافات ميزات بلغة Kotlin تمكّنك من كتابة لغة Kotlin مختصرة وأصلية عند تطويرها إلى SDK للخرائط في Android. خرائط KTX برنامج مفتوح المصدر ومتوفرة على GitHub بالإضافة إلى أمثلة.
تثبيت
لإضافة ملف KTX لـ Maps SDK لنظام التشغيل Android، واختياريًا لـ Maps SDK لمكتبة Android Utility، أضف التبعيات التالية إلى ملف build.gradle
.
dependencies {
// KTX for the Maps SDK for Android
implementation 'com.google.maps.android:maps-ktx:3.2.1'
// (Optional) KTX for the Maps SDK for Android Utility Library
implementation 'com.google.maps.android:maps-utils-ktx:3.2.1'
}
أمثلة على الاستخدام
باستخدام مكتبة KTX، يمكنك الاستفادة من العديد من ميزات لغة Kotlin مثل دوال الإضافات والمعلّمات المُسمّاة والوسيطات التلقائية وتدمير التصريحات والكوروتينات.
استرداد خريطة Google باستخدام الكوروتينات
ويمكن استعادة الوصول إلى GoogleMap
باستخدام الكوروتينات.
lifecycleScope.launchWhenCreated { val mapFragment: SupportMapFragment? = supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment val googleMap: GoogleMap? = mapFragment?.awaitMap() }
إضافة علامة
يمكن إضافة علامة باستخدام أسلوب DSL addMarker()
.
val sydney = LatLng(-33.852, 151.211) val marker = googleMap.addMarker { position(sydney) title("Marker in Sydney") }
جمع أحداث الكاميرا
يمكن جمع الأحداث، مثل حركات الكاميرا، من خلال تدفق Kotlin.
lifecycleScope.launchWhenCreated { googleMap.cameraMoveEvents().collect { print("Received camera move event") } }
يمكنك الاطّلاع على قائمة كاملة بالميزات المتاحة من خلال قراءة المستندات المرجعية.