خرائط KTX لنظام التشغيل Android

تمثل إضافات خرائط 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")
  }
}

يمكنك الاطّلاع على قائمة كاملة بالميزات المتاحة من خلال قراءة المستندات المرجعية.