שליטה בהתנהגות במקרה של חפיפה

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

בדף הזה מוסבר איך מגדירים את התנהגות ההתנגשות של סמן. התנהגות במקרה של חפיפה קובעת איך סמן יוצג אם הוא מתנגש (חופף) עם סמן אחר.

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

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

בדוגמה הבאה מוצגת הגדרת התנהגות במקרה של חפיפה לסמן:

const marker = new Marker3DElement({
    position: { lat, lng },
    // Try setting a different collision behavior here.
    collisionBehavior: 'REQUIRED',
});