מפות ל-Android KTX

התוספים של Kotlin ל-Android (KTX) הם אוסף של תוספים ל-Kotlin ל-SDK של מפות ל-Android ולספריית התכונות של SDK של מפות ל-Android. התוספים האלה מספקים תכונות של שפת Kotlin שמאפשרות לכתוב קוד Kotlin תמציתי ותרבותי כשמפתחים ל-SDK של מפות ל-Android. 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("com.google.maps.android:maps-ktx:5.1.1")
}

דוגמאות לשימוש

באמצעות ספריית KTX תוכלו ליהנות מכמה מאפיינים של שפת Kotlin, כמו פונקציות הרחבה, פרמטרים עם שם וארגומנטים שמוגדרים כברירת מחדל, הצהרות של ניתוח מבנה ו-coroutines.

אחזור של מפה של Google באמצעות קורוטינים

אפשר לגשת ל-GoogleMap באמצעות פונקציות רפיטיביות.

lifecycleScope.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    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 Flow.

lifecycleScope.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    googleMap.cameraMoveEvents().collect {
      print("Received camera move event")
    }
  }
}

רשימה מלאה של התכונות הנתמכות מופיעה בחומר העזר.

ניסיון באפליקציה לדוגמה

המאגר של הספרייה הזו ב-GitHub מכיל גם אפליקציית הדגמה שמראה איך משתמשים בספריית KTX של מפות Google באפליקציה שלכם.

כדי לנסות את אפליקציית הדגמה:

1. ב-GitHub, מעתיקים את קובץ ה-ZIP או מורידים אותו.
2. ב-Android Studio, בוחרים באפשרות File -> Open (קובץ -> פתיחה), עוברים לספרייה ופותחים את התיקייה ששכפלתם או הורדתם.
3. מוסיפים מפתח API לאפליקציית הדגמה.
1. קבלת מפתח ל-SDK של מפות ל-Android
2. בתיקיית השורש, יוצרים קובץ בשם secrets.properties. כדי להגן על מפתח ה-API, אין להעביר את הקובץ הזה לבקרת גרסאות.
3. מוסיפים את השורה היחידה הזו לקובץ secrets.properties
   

   MAPS_API_KEY="YOUR_API_KEY"

   כאשר YOUR_API_KEY הוא מפתח ה-API בפועל שקיבלתם בשלב הראשון. אפשר להיעזר בדוגמה של secrets.defaults.properties.
4. בקטע run configuration, בוחרים את המודול app-ktx.
5. בוחרים באפשרות הפעלת 'app-ktx'.

המאמרים הבאים

יכול להיות שספריות ההרחבה הנוספות של Kotlin לפלטפורמה של מפות Google יעניינו אתכם:

• KTX לספריית התמיכה של Map SDK ל-Android
• KTX ל-Places SDK ל-Android