رفتار برخورد را کنترل کنید

پلتفرم مورد نظر را انتخاب کنید: اندروید، iOS، جاوا اسکریپت

رفتار برخورد، نحوه نمایش یک نشانگر را در صورت برخورد (همپوشانی) با نشانگر دیگری کنترل می‌کند.

تنظیم رفتار برخورد برای یک نشانگر

برای تنظیم رفتار برخورد، GMSAdvancedMarker.collisionBehavior را روی یکی از موارد زیر تنظیم کنید:

  • GMSCollisionBehaviorRequired (پیش‌فرض): همیشه نشانگر را صرف نظر از برخورد نمایش می‌دهد. این رفتار پیش‌فرض است. هیچ تاثیری بر نمایش سایر نشانگرها یا برچسب‌های نقشه پایه ندارد.

  • GMSCollisionBehaviorOptionalAndHidesLowerPriority : نشانگر را فقط در صورتی نمایش می‌دهد که با نشانگرهای دیگر همپوشانی نداشته باشد. اگر دو نشانگر از این نوع همپوشانی داشته باشند، نشانگری که zIndex بالاتری دارد نمایش داده می‌شود. اگر zIndex آنها یکسان باشد، نشانگری که موقعیت عمودی پایین‌تری در صفحه دارد نمایش داده می‌شود.

  • GMSCollisionBehaviorRequiredAndHidesOptional : همیشه نشانگر را صرف نظر از برخورد نمایش دهید و هرگونه GMSCollisionBehaviorOptionalAndHidesLowerPriority را پنهان کنید. نشانگر را فقط در صورتی نمایش دهید که با نشانگرهای دیگر همپوشانی نداشته باشد. این ویژگی GMSCollisionBehaviorRequired را ندارد. اگر دو نشانگر از این نوع همپوشانی داشته باشند، نشانگری که zIndex بالاتری دارد نمایش داده می‌شود. قوانین برخورد برای نشانگرهایی با zIndex یکسان تعریف نشده است.

سویفت

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

هدف-سی

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