מפות ל-Android KTX

תוספי 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 חדש.

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 באפליקציה שלכם.

כדי לנסות את אפליקציית ההדגמה, בצעו את השלבים הבאים:

1. משכפלים או מורידים את קובץ ה-ZIP מ-GitHub.
2. ב-Android Studio, בוחרים באפשרות File -> פותחים, מנווטים לספרייה ופותחים את התיקייה ששכפול או הורדתם.
3. צריך להוסיף מפתח API לאפליקציית ההדגמה.
1. קבלת מפתח של מפות Google ל-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
• KTX ל-Place SDK ל-Android