מפות ל-Android KTX

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

התקנה

כדי להתקין את KTX עבור Maps SDK ל-Android, ואופציונלית עבור Maps SDK ל-Android Utility Library, מוסיפים את יחסי התלות הבאים לקובץ build.gradle.kts.

dependencies {

    // KTX for the Maps SDK for Android library
    implementation("com.google.maps.android:maps-ktx:5.2.0")
}

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

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

אחזור של GoogleMap באמצעות קורוטינות

אפשר לאחזר גישה ל-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 של הספרייה הזו יש גם אפליקציית הדגמה שמראה איך אפשר להשתמש בספריית Maps KTX באפליקציה שלכם.

כדי לנסות את אפליקציית ההדגמה, מבצעים את השלבים הבאים:

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 for Android Utility Library
• ‫KTX ל-Places SDK ל-Android