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

إضافات Kotlin (KTX) في "خرائط Google" على Android هي مجموعة من إضافات Kotlin لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android ومكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android. توفّر هذه الإضافات ميزات لغة Kotlin التي تتيح لك كتابة رموز Kotlin برمجية موجزة ومناسبة عند تطوير تطبيقات تستخدم "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android". تتوفّر حزمة Maps KTX كمصدر مفتوح على GitHub مع أمثلة.

تثبيت

لتثبيت KTX لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android، واختياريًا لمكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android، أضِف التبعيات التالية إلى ملف build.gradle.kts.

dependencies {

    // Maps SDK for Android Utils library (includes KTX extensions)
    implementation(libs.android.maps.utils)
}

أمثلة على الاستخدام

باستخدام مكتبة KTX، يمكنك الاستفادة من العديد من ميزات لغة Kotlin، مثل دوال الإضافة والمعلَمات المسماة والوسيطات التلقائية وتعريفات التفكيك والروتينات الفرعية.

استرداد GoogleMap باستخدام الكوروتين

يمكن استرداد الوصول إلى GoogleMap باستخدام الكوروتين.

scope.launch {
    if (context is FragmentActivity) {
        val mapFragment =
            context.supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
        val googleMap = mapFragment?.awaitMap()
    }
}

إضافة علامة

يمكن إضافة علامة باستخدام طريقة addMarker() بنمط DSL.

val sydney = LatLng(-33.852, 151.211)
val marker = googleMap.addMarker {
    position(sydney)
    title("Marker in Sydney")
}

جمع الأحداث التي رصدتها الكاميرات

يمكن جمع الأحداث، مثل تحرّكات الكاميرا، من خلال Kotlin Flow.

scope.launch {
    googleMap.cameraMoveEvents().collect {
        Log.d("KTX", "Received camera move event")
    }
}

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

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

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

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

1. من GitHub، استنسِخ ملف ZIP أو نزِّله.
2. في "استوديو Android"، اختَر ملف (File) -> فتح (Open) وانتقِل إلى الدليل وافتح المجلد الذي استنسخته أو نزّلته للتو.
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 لمكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android
• KTX لحزمة تطوير برامج الأماكن لأجهزة Android