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

إضافات Kotlin (KTX) في "خرائط Google" هي مجموعة من إضافات Kotlin لحزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لأجهزة Android وحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لمكتبة أدوات Android. توفر هذه الإضافات ميزات لغة Kotlin التي تمكّنك من كتابة لغة Kotlin بإيجاز وتعبيرات عند التطوير من أجل حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط 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.

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

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

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

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

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

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 لحزمة SDK للخرائط لمكتبة أدوات Android
• KTX لحزمة تطوير برامج "الأماكن" لنظام التشغيل Android