تطبيق "خرائط 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"، اختَر ملف -> فتح وانتقِل إلى الدليل وافتح المجلد الذي نسخته أو نزّلته للتو.
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