מפות ל-Android KTX

‫Maps Android Kotlin extensions (KTX)‎ הם אוסף של תוספים ל-Kotlin ל-Maps SDK ל-Android ול-Maps SDK ל-Android Utility Library. ההרחבות האלה מספקות תכונות של שפת 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(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