إضافات Kotlin (KTX) في "خرائط Google" هي مجموعة من إضافات Kotlin لحزمة تطوير البرامج (SDK) الخاصة بخرائط Google. Android وحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لمكتبة أدوات Android تقدّم هذه الإضافات هي ميزات بلغة Kotlin التي تتيح لك كتابة لغة Kotlin بشكل موجز وغامض. عند التطوير لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android يعد Maps KTX برنامجًا مفتوح المصدر المتاحة على GitHub إلى جانب الأمثلة.
تثبيت
لتثبيت KTX لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android، واختياريًا لحزمة تطوير البرامج (SDK) للخرائط
مكتبة أدوات Android، أضِف الملحقات التالية إلى build.gradle.kts
.
الملف.
dependencies { // KTX for the Maps SDK for Android library implementation("com.google.maps.android:maps-ktx:5.1.1") }
أمثلة على الاستخدامات
من خلال مكتبة KTX، يمكنك الاستفادة من العديد من خلفيات مثل دوال الإضافات والمعلمات المسماة والوسيطات الافتراضية، والتصريحات التدميرية، والكوروتين.
استرداد خريطة Google باستخدام الكوروتينات
يمكن استرداد إذن الوصول إلى GoogleMap
باستخدام الكوروتين.
lifecycleScope.launch { lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) { 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.
lifecycleScope.launch { lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) { googleMap.cameraMoveEvents().collect { print("Received camera move event") } } }
يمكنك الاطّلاع على قائمة كاملة بالميزات المتاحة من خلال قراءة المستندات المرجعية
تجربة نموذج التطبيق
يحتوي مستودع GitHub لهذه المكتبة أيضًا على تطبيق تجريبي التي توضح كيفية استخدام مكتبة KTX في "خرائط Google" في تطبيقك.
لتجربة التطبيق التجريبي، اتّبِع الخطوات التالية:
- من GitHub، استنسِخ ملف ZIP أو نزِّله.
- في "استوديو Android"، انقر على ملف -> افتح وانتقِل إلى الدليل وافتح المجلد الذي استنسخته أو نزّلته للتو.
- أضِف مفتاح واجهة برمجة تطبيقات إلى التطبيق التجريبي.
- احصل على حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لمفتاح Android.
- في الدليل الجذر، أنشئ ملفًا باسم
secrets.properties
. يجب ألا يكون هذا الملف خاضعًا للتحكم في الإصدار لحماية مفتاح واجهة برمجة التطبيقات الخاص بك. - إضافة هذا السطر الفردي إلى
secrets.properties
MAPS_API_KEY="YOUR_API_KEY"
حيثYOUR_API_KEY
هو مفتاح واجهة برمجة التطبيقات الفعلي الذي حصلت عليه في الخطوة الأولى. يمكنك إلقاء نظرة علىsecrets.defaults.properties
كمثال. - ضِمن إعدادات التشغيل، اختَر الوحدة app-ktx.
- اختَر تشغيل 'app-ktx'.
الخطوات التالية
قد تكون مهتمًا أيضًا بمكتبات إضافات Kotlin الأخرى لخرائط Google النظام الأساسي: