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" في تطبيقك.
لتجربة التطبيق التجريبي، اتّبِع الخطوات التالية:
- من GitHub، استنسِخ ملف ZIP أو نزِّله.
- في Android Studio، اختَر ملف -> فتح وانتقِل إلى الدليل وافتح المجلد الذي نسخته أو نزّلته للتو.
- أضِف مفتاح واجهة برمجة التطبيقات إلى التطبيق التجريبي.
- احصل على مفتاح حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android.
- في الدليل الجذر، أنشئ ملفًا باسم
secrets.properties
. يجب ألا يكون هذا الملف خاضعًا لإدارة الإصدارات لحماية مفتاح واجهة برمجة التطبيقات. - أضِف هذا السطر الفردي إلى
secrets.properties
MAPS_API_KEY="YOUR_API_KEY"
حيث يكونYOUR_API_KEY
هو مفتاح واجهة برمجة التطبيقات الفعلي الذي حصلت عليه في الخطوة الأولى. يمكنك الاطّلاع علىsecrets.defaults.properties
كمثال. - ضمن إعدادات التشغيل، اختَر الوحدة app-ktx.
- اختَر تشغيل "app-ktx".
الخطوات التالية
قد تهمّك أيضًا مكتبات إضافات Kotlin الأخرى لخرائط Google النظام الأساسي: