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

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