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

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

تثبيت

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

dependencies {

    // KTX for the Maps SDK for Android library
    implementation("com.google.maps.android:maps-ktx:5.1.1")
}

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

باستخدام مكتبة 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 لهذه المكتبة أيضًا على تطبيق تجريبي يوضّح كيفية استخدام مكتبة KTX في "خرائط Google" في تطبيقك.

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

  1. من GitHub، استنسِخ ملف ZIP أو نزِّله.
  2. في Android Studio، اختَر ملف -> فتح وانتقِل إلى الدليل وافتح المجلد الذي نسخته أو نزّلته للتو.
  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 لحزمة تطوير برامج "الأماكن" لنظام التشغيل Android