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 جمع‌آوری شوند.

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 ایجاد کنید. این فایل نباید تحت کنترل نسخه باشد تا از کلید میانای برنامه‌سازی کاربردی شما محافظت شود.
3. این خط تکی را به secrets.properties
   اضافه کنید

   MAPS_API_KEY="YOUR_API_KEY"

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

قدم بعدی چیست

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

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