מפות ל-Android KTX

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

התקנה

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

dependencies {

    // KTX for the Maps SDK for Android library
    implementation(libs.maps.ktx)
}

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

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

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

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

• ‫KTX ל-Map SDK for Android Utility Library
• ‫KTX ל-Places SDK ל-Android