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

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

تثبيت

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

dependencies {

    // KTX for the Maps SDK for Android library
    implementation("com.google.maps.android:maps-ktx:5.1.1")
}

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

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

استرداد خريطة Google باستخدام الكوروتينات

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

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

إضافة علامة

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

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

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

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

lifecycleScope.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    googleMap.cameraMoveEvents().collect {
      print("Received camera move event")
    }
  }
}

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

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

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

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

  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 لحزمة تطوير البرامج (SDK) الخاصة بالخرائط مكتبة أدوات Android
  • KTX لحزمة تطوير برامج الأماكن لنظام التشغيل Android