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