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

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

نصب

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

dependencies {

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

مثال‌های کاربردی

با کتابخانه KTX، می‌توانید از چندین ویژگی زبان کاتلین مانند توابع افزونه، پارامترهای نامگذاری شده و آرگومان‌های پیش‌فرض، تعریف‌های destructuring و coroutineها بهره‌مند شوید.

بازیابی نقشه گوگل با استفاده از کوروتین‌ها

دسترسی به GoogleMap را می‌توان با استفاده ازCoroutineها بازیابی کرد.

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")
    }
  }
}

شما می‌توانید با مطالعه‌ی مستندات مرجع، لیست کاملی از ویژگی‌های پشتیبانی‌شده را مشاهده کنید.

نمونه برنامه را امتحان کنید

مخزن گیت‌هاب این کتابخانه همچنین شامل یک برنامه آزمایشی است که نشان می‌دهد چگونه می‌توانید از کتابخانه Maps KTX در برنامه خود استفاده کنید.

برای امتحان کردن نسخه آزمایشی برنامه، مراحل زیر را دنبال کنید:

1. از گیت‌هاب ، فایل زیپ را کپی یا دانلود کنید.
2. در اندروید استودیو، File -> Open را انتخاب کنید و به دایرکتوری بروید و پوشه‌ای را که اخیراً کلون یا دانلود کرده‌اید، باز کنید.
3. یک کلید API به برنامه آزمایشی اضافه کنید.
1. یک کلید Maps SDK برای اندروید دریافت کنید .
2. در دایرکتوری ریشه، فایلی به نام secrets.properties ایجاد کنید. این فایل نباید تحت کنترل نسخه باشد تا از کلید API شما محافظت کند.
3. این خط را به secrets.properties اضافه کنید
   

   MAPS_API_KEY="YOUR_API_KEY"

   که YOUR_API_KEY کلید API واقعی است که در مرحله اول به دست آورده‌اید. می‌توانید به عنوان مثال به secrets.defaults.properties نگاه کنید.
4. در قسمت پیکربندی اجرا، ماژول app-ktx را انتخاب کنید.
5. اجرای 'app-ktx' را انتخاب کنید.

قدم بعدی چیست؟

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

• کتابخانه ابزار KTX برای نقشه SDK برای اندروید
• کیت توسعه نرم‌افزاری KTX برای مکان‌ها برای اندروید