تطبيق "خرائط 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 {

    // KTX for the Maps SDK for Android library
    implementation(libs.maps.ktx)
}

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

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

استرداد GoogleMap باستخدام البرامج الفرعية

يمكن استرداد GoogleMap باستخدام البرامج الفرعية.

lifecycleScope.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    val mapFragment: SupportMapFragment? =
      supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
    val googleMap: GoogleMap? = mapFragment?.awaitMap()
  }
}

إضافة علامة

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

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

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

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

lifecycleScope.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    googleMap.cameraMoveEvents().collect {
      print("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