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