מפות Android KTX

תוספי Kotlin ל-Android (KTX) הם אוסף של תוספי Kotlin ל-Android SDK ול-SDK של מפות Google ל-Android Utility Directory. התוספים האלה מספקים תכונות של Kotlin בשפה, שמאפשרות לכם לכתוב תמציתית של Kotlin עבור פיתוח SDK של Android. KTX של מפות Google מבוסס על קוד פתוח והוא זמין ב-GitHub יחד עם דוגמאות.

התקנה

כדי להתקין את KTX עבור SDK של מפות ל-Android, ובאופן אופציונלי גם עבור SDK של מפות Google עבור ספריית השירות של Android, מוסיפים את יחסי התלות הבאים לקובץ 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, כמו פונקציות תוספים, פרמטרים בעלי שם וארגומנטים שמוגדרים כברירת מחדל, הצהרות על השמדת נתונים ושגרות.

אחזור של מפות Google באמצעות שגרות

ניתן לאחזר גישה ל-GoogleMap באמצעות שגרה.

lifecycleScope.launchWhenCreated {
  val mapFragment: SupportMapFragment? =
    supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
  val googleMap: GoogleMap? = mapFragment?.awaitMap()
}

הוספת סמן

ניתן להוסיף סמן באמצעות השיטה בסגנון DSL addMarker().

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

איסוף אירועים מהמצלמה

אתם יכולים לאסוף אירועים, כמו תנועות מצלמה, באמצעות זרימתKotlin.

lifecycleScope.launchWhenCreated {
  googleMap.cameraMoveEvents().collect {
    print("Received camera move event")
  }
}

במסמכי התיעוד תוכלו לראות רשימה מלאה של התכונות הנתמכות.