Maps Android KTX

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

نصب

برای نصب KTX برای «کیت توسعه نرم‌افزار Maps ویژه Android»، و به‌صورت اختیاری برای «کتابخانه کاروری‌های کیت توسعه نرم‌افزار Maps ویژه Android»، وابستگی‌های زیر را به فایل build.gradle.kts خود اضافه کنید.

dependencies {

    // Maps SDK for Android Utils library (includes KTX extensions)
    implementation(libs.android.maps.utils)
}

نمونه‌های استفاده

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

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

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

scope.launch {
    if (context is FragmentActivity) {
        val mapFragment =
            context.supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
        val googleMap = mapFragment?.awaitMap()
    }
}

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

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

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

درحال جمع‌آوری رویدادهای دوربین

رویدادها، مانند حرکت‌های دوربین، می‌توانند ازطریق Kotlin Flow جمع‌آوری شوند.

scope.launch {
    googleMap.cameraMoveEvents().collect {
        Log.d("KTX", "Received camera move event")
    }
}

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

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

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

برای امتحان کردن برنامه نمایشی، این مراحل را دنبال کنید:

1. از GitHub، فایل ZIP را شبیه‌سازی یا بارگیری کنید.
2. در «استودیو Android»، فایل -> باز کردن را انتخاب کنید و به دایرکتوری بروید و پوشه‌ای را که به‌تازگی کلون یا بارگیری کرده‌اید باز کنید.
3. کلید میانای برنامه‌سازی کاربردی به برنامه نمایشی اضافه کنید.
1. دریافت کلید کیت توسعه نرم‌افزار Google Maps برای 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’ (اجرای app-ktx) را انتخاب کنید.

قدم بعدی چیست

ممکن است به کتابخانه‌های افزونه Kotlin دیگر برای Google Maps Platform نیز علاقه‌مند باشید:

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