מפות ל-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. משכפלים או מורידים את קובץ ה-ZIP מ-GitHub.
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. בוחרים באפשרות Run 'app-ktx'.

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

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

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