نقشه اندروید 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
    implementation 'com.google.maps.android:maps-ktx:3.2.1'

    // (Optional) KTX for the Maps SDK for Android Utility Library
    implementation 'com.google.maps.android:maps-utils-ktx:3.2.1'
}

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

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

بازیابی GoogleMap با استفاده از کوروتین ها

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

lifecycleScope.launchWhenCreated {
  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.launchWhenCreated {
  googleMap.cameraMoveEvents().collect {
    print("Received camera move event")
  }
}

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