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

إضافات Kotlin في "خرائط Google" على Android (KTX) هي مجموعة من إضافات Kotlin لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android ومكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android. توفّر هذه الإضافات ميزات لغة Kotlin التي تتيح لك كتابة رمز Kotlin برمجي موجز ومناسب عند تطوير تطبيقات تستخدم "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android". ‫Maps KTX هي مكتبة مفتوحة المصدر ومتاحة على GitHub مع أمثلة.

تثبيت

لتثبيت KTX لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android، ولتثبيتها اختياريًا لمكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android، أضِف التبعيات التالية إلى ملف build.gradle.kts.

dependencies {

    // KTX for the Maps SDK for Android library
    implementation(libs.maps.ktx)
}

أمثلة على الاستخدام

باستخدام مكتبة KTX، يمكنك الاستفادة من العديد من ميزات لغة Kotlin، مثل دوال الإضافة والمعلَمات المسماة والوسيطات التلقائية وتعريفات التفكيك والروتينات الفرعية.

استرداد GoogleMap باستخدام إجراءات روتينية مشتركة

يمكن استرداد قيمة GoogleMap باستخدام إجراءات فرعية.

lifecycleScope.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    val mapFragment: SupportMapFragment? =
      supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
    val googleMap: GoogleMap? = mapFragment?.awaitMap()
  }
}

إضافة علامة

يمكن إضافة علامة باستخدام طريقة addMarker() بنمط DSL.

val sydney = LatLng(-33.852, 151.211)
val marker = googleMap.addMarker {
  position(sydney)
  title("Marker in Sydney")
}

جمع الأحداث التي رصدتها الكاميرا

يمكن جمع الأحداث، مثل تحرّكات الكاميرا، من خلال Kotlin Flow.

lifecycleScope.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    googleMap.cameraMoveEvents().collect {
      print("Received camera move event")
    }
  }
}

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

تجربة التطبيق النموذجي

يحتوي مستودع GitHub الخاص بهذه المكتبة أيضًا على تطبيق تجريبي يوضّح كيفية استخدام مكتبة Maps KTX في تطبيقك.

لتجربة التطبيق التجريبي، اتّبِع الخطوات التالية:

  1. من GitHub، استنسِخ الملف أو نزِّل ملف ZIP.
  2. في "استوديو Android"، اختَر ملف -> فتح وانتقِل إلى الدليل وافتح المجلد الذي نسخته أو نزّلته للتو.
  3. أضِف مفتاح واجهة برمجة تطبيقات إلى التطبيق التجريبي.
    1. احصل على مفتاح حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android.
    2. في الدليل الجذر، أنشئ ملفًا باسم secrets.properties. يجب ألا يكون هذا الملف خاضعًا للتحكّم في الإصدار لحماية مفتاح واجهة برمجة التطبيقات.
    3. أضِف هذا السطر الفردي إلى secrets.properties
      MAPS_API_KEY="YOUR_API_KEY"
       حيث YOUR_API_KEY هو مفتاح واجهة برمجة التطبيقات الفعلي الذي حصلت عليه في الخطوة الأولى. يمكنك الاطّلاع على secrets.defaults.properties كمثال.
  4. ضمن إعدادات التشغيل، اختَر الوحدة app-ktx.
  5. اختَر تشغيل "app-ktx".

الخطوات التالية

قد تهمّك أيضًا مكتبات إضافات Kotlin الأخرى لمنصة "خرائط Google":

  • KTX لمكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android
  • ‫KTX لحزمة تطوير البرامج Places SDK لنظام التشغيل Android