מפות ל-Android KTX

תוספי Kotlin‏ (KTX) למפות ל-Android הם אוסף של תוספי 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 {

    // Maps SDK for Android Utils library (includes KTX extensions)
    implementation(libs.android.maps.utils)
}

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

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

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

אפשר לאחזר גישה ל-GoogleMap באמצעות פונקציות קורוטין.

scope.launch {
    if (context is FragmentActivity) {
        val mapFragment =
            context.supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
        val googleMap = mapFragment?.awaitMap()
    }
}

הוספת סמן

אפשר להוסיף סמן באמצעות השיטה addMarker() בסגנון DSL.

val sydney = LatLng(-33.852, 151.211)
val marker = googleMap.addMarker {
    position(sydney)
    title("Marker in Sydney")
}

איסוף אירועים שתועדו במצלמה

אפשר לאסוף אירועים, כמו תנועות מצלמה, באמצעות Kotlin Flow.

scope.launch {
    googleMap.cameraMoveEvents().collect {
        Log.d("KTX", "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. בוחרים באפשרות הפעלת app-ktx.

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

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

• ‫KTX ל-SDK של מפות ל-Android Utility Library
• ‫KTX ל-Places SDK ל-Android