تطبيق "خرائط Google" لنظام التشغيل Android KTX

إضافات لغة 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")
  }
}

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