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

إضافات Kotlin في "خرائط Google" لنظام التشغيل Android (KTX) هي مجموعة من إضافات 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("com.google.maps.android:maps-ktx:5.2.0")
}

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

باستخدام مكتبة 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 لحزمة تطوير البرامج Places SDK لنظام التشغيل Android