מפות ל-Android KTX

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

התקנה

כדי להתקין את KTX ל-SDK של מפות Google ל-Android, ואם רוצים, גם את ה-SDK של מפות Google ל-Android Utility Library, צריך להוסיף את יחסי התלות הבאים לקובץ build.gradle.

dependencies {

    // KTX for the Maps SDK for Android library
    implementation 'com.google.maps.android:maps-ktx:5.0.0'
}

שימושים לדוגמה

בעזרת ספריית KTX אפשר להשתמש בכמה תכונות שפה של Kotlin כמו פונקציות תוסף, פרמטרים בעלי שם וארגומנטים של ברירת מחדל, ביטול הצהרות ופונקציות Coroutine.

אחזור של מפות 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 -> 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. בוחרים באפשרות Run 'app-ktx'.

מה עושים אחר כך

כדאי גם לעיין בספריות תוספים אחרות של Kotlin לפלטפורמת מפות Google:

• KTX בשביל Map SDK עבור Android Utility Library
• KTX בשביל Places SDK ל-Android