إنّ إضافات " Kotlin" في "خرائط Google" (KTX) هي مجموعة من إضافات Kotlin في حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لأجهزة Android و"خرائط Google" وحزمة تطوير برامج "خرائط Google" لمكتبة تطبيقات Android. وتوفّر هذه الإضافات ميزات لغة Kotlin التي تمكّنك من كتابة لغة Kotlin موجزة وأصلية عند تطوير حزمة تطوير البرامج (SDK) في "خرائط Google" لأجهزة Android. "خرائط Google KTX" المصدر مفتوح المصدر ومتاح على GitHub بالإضافة إلى أمثلة.
تثبيت
لتثبيت KTX في "خرائط Google" لحزمة تطوير البرامج (SDK) لنظام التشغيل Android، واختياريًا لحزمة تطوير برامج "خرائط Google" لمكتبة 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")
}
}
يمكنك الاطّلاع على قائمة كاملة بالميزات المتاحة من خلال قراءة المستندات المرجعية.