إضافات Kotlin (KTX) في "خرائط Google" هي مجموعة من إضافات Kotlin لحزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android وحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لمكتبة أدوات Android. توفر هذه الإضافات ميزات لغة Kotlin التي تمكّنك من كتابة لغة Kotlin بإيجاز وتعبيرات عند التطوير من أجل "SDK لخرائط Google" لنظام التشغيل Android. تطبيق Maps KTX مفتوح المصدر ومتاح على GitHub إلى جانب أمثلة.
تثبيت
لتثبيت KTX لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android، وكذلك لحزمة تطوير البرامج بالاستناد إلى "خرائط Google" لمكتبة أدوات Android، أضِف العناصر التابعة التالية إلى ملف build.gradle.
dependencies {
// KTX for the Maps SDK for Android library
implementation 'com.google.maps.android:maps-ktx:5.0.0'
}
أمثلة على الاستخدامات
ومن خلال مكتبة KTX، يمكنك الاستفادة من العديد من ميزات لغة Kotlin، مثل دوال الإضافات والمعلَمات المُسمّاة والوسيطات التلقائية وتعريفات إتلاف لغة Kotlin.
استرداد خريطة 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: