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

אחזור של מפה של 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. בתצורת ההרצה, בוחרים את המודול app-ktx.
5. בוחרים באפשרות הפעלת 'app-ktx'.

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

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

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