מפות ל-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, כמו פונקציות הרחבה, פרמטרים בעלי שם וארגומנטים שמוגדרים כברירת מחדל, הצהרות על פירוק מבנים וקורוטינות.

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

אפשר לאחזר גישה ל-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. בוחרים באפשרות Run 'app-ktx'‎.

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

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

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