ניהול סמנים, תוויות והתנגשויות של נקודות עניין

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

לפני שמתחילים

כדי לנהל התנגשויות בין סמנים ותוויות, צריך להשתמש במזהה מפה.

אם אתם משתמשים בתמונת מפה מסוג מפת סיביות (bitmap) דרך מצב בסיסי, אתם לא יכולים לנהל התנגשויות בין סמנים ותוויות.

ציון סדרי העדיפויות של הסמנים

משתמשים בMarker.CollisionBehavior כדי לציין את העדיפות של סמן.

משתמשים באחד מהערכים הבאים:

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

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

Kotlin

// Collision behavior can only be changed in the AdvancedMarkerOptions object.
// Changes to collision behavior after a marker has been created are not possible
val collisionBehavior: Int = CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL
val advancedMarkerOptions: AdvancedMarkerOptions = AdvancedMarkerOptions()
    .position(LatLng(10.0, 10.0))
    .collisionBehavior(collisionBehavior)

val marker: Marker = map.addMarker(advancedMarkerOptions) ?: error("Failed to add marker")

Java

// Collision behavior can only be changed in the AdvancedMarkerOptions object.
// Changes to collision behavior after a marker has been created are not possible
int collisionBehavior = AdvancedMarkerOptions.CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL;
AdvancedMarkerOptions options = new AdvancedMarkerOptions()
        .position(new LatLng(10.0, 10.0))
        .collisionBehavior(collisionBehavior);

Marker marker = map.addMarker(options);