תוספים של Maps Android Kotlin (KTX) הם אוסף של תוספים של Kotlin עבור Maps SDK ל-Android ו-Maps SDK for Android Utility Library. התוספים האלה מספקים תכונות של שפה ב-Kotlin שמאפשרות לכתוב ב-Kotlin תמציתי ואידיומטי במהלך הפיתוח ל-SDK של מפות Google ל-Android. Maps KTX הוא קוד פתוח וזמין ב-GitHub יחד עם דוגמאות.
התקנה
כדי להתקין את KTX בשביל ה-SDK של מפות Google ל-Android, ואם רוצים, גם את Maps SDK לספריית הכלים של Android, מוסיפים את יחסי התלות הבאים לקובץ build.gradle
.
dependencies { // KTX for the Maps SDK for Android library implementation 'com.google.maps.android:maps-ktx:5.0.0' }
שימושים לדוגמה
בספריית KTX תוכלו להשתמש בכמה תכונות של שפה ב-Kotlin, כמו פונקציות תוסף, פרמטרים בעלי שם וארגומנטי ברירת מחדל, הצהרות השמדות וקורוטינים.
אחזור מפות Google באמצעות coroutines
אפשר לאחזר גישה אל 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") }
מתבצע איסוף של אירועי מצלמה
אפשר לאסוף אירועים, כמו תנועות של המצלמה, באמצעות Kotlinflow.
lifecycleScope.launch { lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) { googleMap.cameraMoveEvents().collect { print("Received camera move event") } } }
הרשימה המלאה של התכונות הנתמכות זמינה במסמכי התיעוד.
רוצה לנסות את האפליקציה לדוגמה?
במאגר הנתונים של GitHub בספרייה הזו יש גם אפליקציית הדגמה שמראה איך אפשר להשתמש בספריית KTX של מפות Google באפליקציה שלכם.
כדי לנסות את אפליקציית ההדגמה, בצעו את השלבים הבאים:
- משכפלים או מורידים את קובץ ה-ZIP מ-GitHub.
- ב-Android Studio, בוחרים באפשרות קובץ -> פתיחה, עוברים לספרייה ופותחים את התיקייה ששכפלתם או הורדתם.
- ניתן להוסיף מפתח API לאפליקציית ההדגמה.
- קבלה של מפתח SDK של מפות ל-Android.
- בתיקיית השורש, יוצרים קובץ בשם
secrets.properties
. כדי להגן על מפתח ה-API, הקובץ הזה לא יכול להיות תחת ניהול גרסאות. - מוסיפים את השורה היחידה הזו אל
secrets.properties
MAPS_API_KEY="YOUR_API_KEY"
כאשרYOUR_API_KEY
הוא מפתח ה-API שקיבלתם בפועל בשלב הראשון. אפשר לראות אתsecrets.defaults.properties
כדוגמה. - בהגדרות ההרצה, בוחרים את המודול app-ktx.
- בוחרים באפשרות Run 'app-ktx'.
המאמרים הבאים
ייתכן שתתעניינו גם בספריות אחרות של תוספים של Kotlin עבור הפלטפורמה של מפות Google: