إضافات لغة Kotlin لنظام التشغيل Android هي مجموعة من إضافات لغة البرمجة Kotlin التي تخصّ "حزمة تطوير البرامج (SDK) لخرائط Google" لنظام التشغيل Android وحزمة تطوير البرامج "SDK" لتطبيق "خرائط Google" لنظام التشغيل Android Utility. توفر هذه الإضافات ميزات لغة Kotlin التي تتيح لك كتابة لغة Kotlin مختصرة واصطلاحية عند تطويرها لحزمة SDK لتطبيق "خرائط Google" لنظام التشغيل Android. يُعد تطبيق "خرائط KTX" برنامجًا مفتوح المصدر ومتاحًا على GitHub مع أمثلة.
تثبيت
لتثبيت KTX لـ Maps SDK لنظام التشغيل Android، واختياريًا لـ Maps SDK for
Android Utility Library، أضف التبعيات التالية إلى ملف 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 Flow.
lifecycleScope.launchWhenCreated {
googleMap.cameraMoveEvents().collect {
print("Received camera move event")
}
}
يمكنك الاطّلاع على قائمة كاملة بالميزات المتاحة من خلال قراءة المستندات المرجعية.