نقشه اندروید KTX

نقشه‌های افزودنی Android Kotlin (KTX) مجموعه‌ای از برنامه‌های افزودنی Kotlin برای Maps SDK برای Android و Maps SDK for Android Utility Library هستند. این برنامه‌های افزودنی ویژگی‌های زبان Kotlin را ارائه می‌کنند که به شما امکان می‌دهد هنگام توسعه برای Maps SDK برای Android، Kotlin مختصر و اصطلاحی بنویسید. Maps KTX منبع باز است و همراه با مثال در GitHub در دسترس است.

نصب و راه اندازی

برای نصب KTX برای Maps SDK برای Android، و به صورت اختیاری برای Maps SDK for Android Utility Library، وابستگی‌های زیر را به فایل build.gradle خود اضافه کنید.

dependencies {

    // KTX for the Maps SDK for Android library
    implementation 'com.google.maps.android:maps-ktx:5.0.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()
  }
}

افزودن نشانگر

افزودن نشانگر را می توان با استفاده از روش DSL-style addMarker() انجام داد.

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 Studio، File -> Open را انتخاب کنید و به دایرکتوری بروید و پوشه ای را که به تازگی کلون کرده یا دانلود کرده اید باز کنید.
  3. یک کلید API به برنامه آزمایشی اضافه کنید.
    1. یک Maps SDK برای کلید Android دریافت کنید .
    2. در فهرست اصلی، فایلی به نام secrets.properties ایجاد کنید. این فایل برای محافظت از کلید API شما نباید تحت کنترل نسخه باشد.
    3. این خط واحد را به secrets.properties اضافه کنید
      MAPS_API_KEY="YOUR_API_KEY"
      که در آن YOUR_API_KEY کلید API واقعی است که در مرحله اول به دست آوردید. می توانید به عنوان مثال به secrets.defaults.properties نگاه کنید.
  4. در پیکربندی اجرا، ماژول app-ktx را انتخاب کنید.
  5. Run 'app-ktx' را انتخاب کنید.

بعدش چی

همچنین ممکن است به سایر کتابخانه های افزودنی Kotlin برای پلتفرم نقشه های گوگل علاقه مند شوید:

  • KTX برای نقشه SDK برای کتابخانه ابزار اندروید
  • KTX برای Places SDK برای اندروید