Trang này minh hoạ cách đặt hành vi va chạm cho một điểm đánh dấu.
Hành vi va chạm kiểm soát cách một điểm đánh dấu sẽ hiển thị nếu điểm đó va chạm (chồng lên) với một điểm đánh dấu khác.
Để đặt hành vi va chạm, hãy đặt collisionBehavior thành một trong những giá trị sau:
REQUIRED: Luôn hiển thị điểm đánh dấu bất kể có xảy ra xung đột hay không
REQUIRED_AND_HIDES_OPTIONAL: Luôn hiển thị điểm đánh dấu bất kể có xảy ra xung đột hay không và ẩn mọi điểm đánh dấu OPTIONAL_AND_HIDES_LOWER_PRIORITY hoặc nhãn trùng lặp với điểm đánh dấu.
OPTIONAL_AND_HIDES_LOWER_PRIORITY: Chỉ hiển thị điểm đánh dấu nếu điểm đó không trùng lặp với các điểm đánh dấu khác. Nếu hai điểm đánh dấu thuộc loại này trùng nhau, thì điểm đánh dấu có zIndex cao hơn sẽ xuất hiện. Nếu có cùng zIndex, thì ảnh chụp màn hình có vị trí màn hình dọc thấp hơn sẽ xuất hiện.
Ví dụ sau đây minh hoạ cách đặt hành vi va chạm cho một điểm đánh dấu:
[null,null,["Cập nhật lần gần đây nhất: 2025-07-22 UTC."],[],[],null,["Select platform: [Android](/maps/documentation/maps-3d/android-sdk/configure-marker-collision-behavior \"View this page for the Android platform docs.\") [iOS](/maps/documentation/maps-3d/ios-sdk/configure-marker-collision-behavior \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/3d/marker-collision \"View this page for the JavaScript platform docs.\")\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| This product or feature is in Preview (pre-GA). Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by the [Google\n| Maps Platform Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms). For more information, see the [launch stage\n| descriptions](/maps/launch-stages).\n\n\u003cbr /\u003e\n\n\nThis page demonstrates how to set the collision behavior for a marker.\nCollision behavior controls how a marker will display if it collides (overlaps)\nwith another marker.\n\nTo set collision behavior, set `collisionBehavior` to one of the following:\n\n- `REQUIRED`: Always display the marker regardless of collision\n- `REQUIRED_AND_HIDES_OPTIONAL`: Always display the marker regardless of collision, and hide any `OPTIONAL_AND_HIDES_LOWER_PRIORITY` markers or labels that would overlap with the marker.\n- `OPTIONAL_AND_HIDES_LOWER_PRIORITY`: Display the marker only if it does not overlap with other markers. If two markers of this type would overlap, the one with the higher `zIndex` is shown. If they have the same `zIndex`, the one with the lower vertical screen position is shown.\n\nThe following example shows setting collision behavior for a marker: \n\n const marker = new Marker3DElement({\n position: {lat, lng},\n collisionBehavior: google.maps.CollisionBehavior.REQUIRED\n });"]]