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

اختيار النظام الأساسي: Android iOS JavaScript

يتحكّم سلوك التصادم في طريقة عرض العلامة إذا تصادمت (تداخلت) مع علامة أخرى.

ضبط سلوك التصادم لعلامة

لضبط سلوك التصادم، اضبط GMSAdvancedMarker.collisionBehavior على أحد الخيارات التالية:

  • GMSCollisionBehaviorRequired (تلقائي): يتم عرض العلامة دائمًا بغض النظر عن التصادم. هذا هو السلوك التلقائي. ولن يؤثّر ذلك في ما إذا كانت أي علامات أو تصنيفات للخريطة الأساسية تظهر أم لا.

  • GMSCollisionBehaviorOptionalAndHidesLowerPriority: يتم عرض العلامة فقط إذا لم تتداخل مع علامات أخرى. إذا كان من المفترض أن تتداخل علامتان من هذا النوع، يتم عرض العلامة التي لها قيمة zIndex أعلى. إذا كان لهما نفس قيمة zIndex، يتم عرض العلامة التي لها موضع شاشة عمودي أقل.

  • GMSCollisionBehaviorRequiredAndHidesOptional: يتم عرض العلامة دائمًا بغض النظر عن التصادم، ويتم إخفاء أي علامة GMSCollisionBehaviorOptionalAndHidesLowerPriority. يتم عرض العلامة فقط إذا لم تتداخل مع علامات أخرى. لا يتم عرض GMSCollisionBehaviorRequired. إذا كان من المفترض أن تتداخل علامتان من هذا النوع، يتم عرض العلامة التي لها قيمة zIndex أعلى. قواعد التصادم للعلامات التي لها نفس قيمة zIndex غير محدّدة.

Swift

// Defines a marker to always display and hide any marker or label overlay with this marker in the base map
marker.collisionBehavior = .requiredAndHidesOptional

Objective-C

// Defines a marker to always display and hide any marker or label overlay with this marker in the base map
marker.collisionBehavior = GMSCollisionBehaviorRequiredAndHidesOptional