التحكّم في سلوك التصادم

اختيار النظام الأساسي: 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);