מפות ל-Android KTX

תוספי Android Kotlin של מפות Google הם אוסף של תוספי Kotlin עבור ה-SDK של מפות Google עבור Android וה-SDK של מפות Google עבור Android Utility Library. התוספים האלה מספקים תכונות שפה של Kotlin שמאפשרות לכתוב Kotlin תמציתי ואידיומטי כשמפתחים עבור ה-SDK של מפות Google ל-Android. Maps KTX הוא קוד פתוח וזמין ב-GitHub יחד עם דוגמאות.

התקנה

כדי להתקין את KTX ל-Maps SDK for Android, ואם רוצים גם ל-Maps SDK for Android Utility Library, מוסיפים את יחסי התלות הבאים לקובץ 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()
  }
}

הוספת סמן

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

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. ב-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
• KTX ל-Places SDK ל-Android