הגדרת התנהגות של התנגשויות בין סמנים

כדי לקבוע איך הסמן יתנהג כשהוא מתנגש עם סמן אחר או עם תווית במפה, מגדירים את המאפיין collisionBehavior לאחד מהערכים הבאים:

• REQUIRED: הסמן תמיד יוצג, גם אם יש התנגשויות.
• ‫REQUIRED_AND_HIDES_OPTIONAL: הסמן תמיד יוצג, גם אם יש התנגשויות. סמנים עם OPTIONAL_AND_HIDES_LOWER_PRIORITY התנהגות במקרה של חפיפה או תוויות ברירת המחדל של המפה שחופפות לסמן הזה יוסתרו.
• ‫OPTIONAL_AND_HIDES_LOWER_PRIORITY: הסמן יוצג רק אם הוא לא חופף לסמנים אחרים. אם שני סמנים מהסוג הזה חופפים, יוצג הסמן עם סדר השרטוט הגבוה יותר. אם יש להם אותו סדר ציור, מוצג זה שנמצא במיקום נמוך יותר במסך האנכי.

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

// Add imports
import com.google.android.gms.maps3d.model.latLngAltitude

...

// Marker 1: REQUIRED
googleMap3D.addMarker(markerOptions {
    position = latLngAltitude {
        latitude = 52.52027645136134
        longitude = 13.408271658592406
        altitude = 0.0
    }
    label = "Collision Behavior: REQUIRED"
    altitudeMode = AltitudeMode.CLAMP_TO_GROUND
    isExtruded = true
    isDrawnWhenOccluded = true
    collisionBehavior = CollisionBehavior.REQUIRED
})

// Marker 2: REQUIRED_AND_HIDES_OPTIONAL
googleMap3D.addMarker(markerOptions {
    position = latLngAltitude {
        latitude = 52.519605780912585
        longitude = 13.406867190588198
        altitude = 150.0
    }
    label = "Colliding Behavior: REQUIRED_AND_HIDES_OPTIONAL"
    altitudeMode = AltitudeMode.ABSOLUTE
    isExtruded = true
    isDrawnWhenOccluded = true
    collisionBehavior = CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL
})

// Marker 3: OPTIONAL_AND_HIDES_LOWER_PRIORITY
googleMap3D.addMarker(markerOptions {
    position = latLngAltitude {
        latitude = 52.519882191069016
        longitude = 13.407410777254293
        altitude = 50.0
    }
    label = "Colliding Behavior: OPTIONAL_AND_HIDES_LOWER_PRIORITY"
    altitudeMode = AltitudeMode.RELATIVE_TO_GROUND
    isExtruded = true
    isDrawnWhenOccluded = true
    collisionBehavior = CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY
})