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

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

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

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

  • REQUIRED: תמיד להציג את הסמן, גם אם יש חפיפה
  • ‫REQUIRED_AND_HIDES_OPTIONAL: הסמן תמיד יוצג, גם אם יש חפיפה, וכל הסמנים או התוויות מסוג 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',
});

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

אפשר לשלוט בהתנהגות במקרה של חפיפה של הסיכה ושל טקסט התווית של הסמן בנפרד. במקרים מסוימים, יכול להיות שכדאי להסתיר את התוויות ולהשאיר את סיכות הסמן גלויות במסך כדי לשמור על ההקשר. כדי לעשות את זה, מוסיפים רכיב <gmp-label-3d> כרכיב אחים של <gmp-marker-3d> ומקשרים ביניהם באמצעות המאפיין for.

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

const markerWithIndependentLabel = new Marker3DElement({
    position: { lat: 37.423, lng: -122.015 },
});
markerWithIndependentLabel.id = 'marker-1';
const label = new Label3DElement({
    collisionBehavior: CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY,
    for: 'marker-1',
});
label.append('Independent label example');
map.append(markerWithIndependentLabel);
map.append(label);