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