הוספת מודל תלת-ממדי למפה

בחירת פלטפורמה: Android iOS JavaScript

מודל תלת-ממדי במפה

בדוגמת הקוד הבאה אפשר לראות איך מוסיפים מודל תלת-ממדי וממקמים אותו במרחב תלת-ממדי באמצעות הקריאה למתודה addModel. כדי להשתמש בדוגמת הקוד הזו, צריך לפעול לפי ההוראות שבמאמרים הגדרה והוספת מפה תלת-ממדית לאפליקציה כדי להגדיר את פרויקט Android Studio עם מפה תלת-ממדית בסיסית. לאחר מכן, מוסיפים את הקוד הבא לקובץ MainActivity.kt:

// Add imports and define constants
import com.google.android.gms.maps3d.model.latLngAltitude
val PLANE_URL = "https://storage.googleapis.com/gmp-maps-demos/p3d-map/assets/Airplane.glb"
val PLANE_SCALE = 0.05

// Add to the onMap3DViewReady method, after the googleMap3D object has been initialized
googleMap3D.setCamera(
   camera {
        center = latLngAltitude {
            latitude = 47.133971
            longitude = 11.333161
            altitude = 2200.0
        }
        heading = 221.0
        tilt = 65.0
        range = 1_200.0
    }
)

googleMap3D.addModel(
    modelOptions {
        id = "plane_model"
        position = latLngAltitude {
            latitude = 47.133971
            longitude = 11.333161
            altitude = 2200.0
        }
        altitudeMode = AltitudeMode.ABSOLUTE
        orientation = orientation {
            heading = 41.5
            tilt = -90.0
            roll = 0.0
        }
        url = PLANE_URL
        scale = vector3D {
            x = PLANE_SCALE
            y = PLANE_SCALE
            z = PLANE_SCALE
        }
    }
)

המתנה לאירועים מסוג קליק על מודל תלת-ממדי

כדי להאזין לאירועי קליקים במודל תלת-ממדי, קוראים ל-setClickListener באובייקט המודל. הדוגמה הבאה מראה איך מגדירים מאזין לקליקים במודל תלת-ממדי:

model.setClickListener {
    lifecycleScope.launch(Dispatchers.Main) {
        Toast.makeText(this@ModelsActivity, "Model clicked", Toast.LENGTH_SHORT).show()
    }
}

חשוב לדעת: handler הקליקים לא פועל ב-thread הראשי (או ב-thread של ממשק המשתמש). אם רוצים לבצע שינויים בממשק המשתמש (למשל להציג הודעת טוסט), צריך לעבור לשרשור הראשי. ב-Kotlin, אפשר לעשות את זה באמצעות lifecycleScope.launch(Dispatchers.Main).