מפות ל-Android KTX

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

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

  1. משכפלים או מורידים את קובץ ה-ZIP מ-GitHub.
  2. ב-Android Studio, בוחרים באפשרות קובץ -> פתיחה, עוברים לספרייה ופותחים את התיקייה ששכפלתם או הורדתם.
  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 ל-Maps SDK בספריית הכלים של Android
  • KTX ל-Places SDK ל-Android