Advanced Markers

Lớp AdvancedMarkerElement

Lớp google.maps.marker.AdvancedMarkerElement

Hiển thị một vị trí trên bản đồ. Xin lưu ý rằng bạn phải đặt position để AdvancedMarkerElement hiển thị.

Phần tử tuỳ chỉnh:
<gmp-advanced-marker gmp-clickable position="lat,lng" title="string"></gmp-advanced-marker>

Lớp này mở rộng HTMLElement.

Lớp này triển khai AdvancedMarkerElementOptions.

Truy cập bằng cách gọi const {AdvancedMarkerElement} = await google.maps.importLibrary("marker").
Xem Thư viện trong Maps JavaScript API.

Thuộc tính
collisionBehavior	Loại:  CollisionBehavior optional Vui lòng xem AdvancedMarkerElementOptions.collisionBehavior.
gmpClickable	Loại:  boolean optional Vui lòng xem AdvancedMarkerElementOptions.gmpClickable. Thuộc tính HTML: <gmp-advanced-marker gmp-clickable></gmp-advanced-marker>
gmpDraggable	Loại:  boolean optional Vui lòng xem AdvancedMarkerElementOptions.gmpDraggable.
map	Loại:  Map optional Vui lòng xem AdvancedMarkerElementOptions.map.
position	Loại:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Vui lòng xem AdvancedMarkerElementOptions.position. Thuộc tính HTML: <gmp-advanced-marker position="lat,lng"></gmp-advanced-marker> <gmp-advanced-marker position="lat,lng,altitude"></gmp-advanced-marker>
title	Loại:  string Vui lòng xem AdvancedMarkerElementOptions.title. Thuộc tính HTML: <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex	Loại:  number optional Vui lòng xem AdvancedMarkerElementOptions.zIndex.
element	Loại:  HTMLElement Trường này ở chế độ chỉ đọc. Phần tử DOM hỗ trợ khung hiển thị.
content	Loại:  Node optional Vui lòng xem AdvancedMarkerElementOptions.content.

Sự kiện
click	function(event) Đối số:  event:  MapMouseEvent Sự kiện này được kích hoạt khi người dùng nhấp vào phần tử AdvancedMarkerElement. Không dùng được với addEventListener() (thay vào đó, hãy dùng gmp-click).
drag	function(event) Đối số:  event:  MapMouseEvent Sự kiện này được kích hoạt nhiều lần trong khi người dùng kéo AdvancedMarkerElement. Không có sẵn trên addEventListener().
dragend	function(event) Đối số:  event:  MapMouseEvent Sự kiện này được kích hoạt khi người dùng ngừng kéo AdvancedMarkerElement. Không có sẵn trên addEventListener().
dragstart	function(event) Đối số:  event:  MapMouseEvent Sự kiện này được kích hoạt khi người dùng bắt đầu kéo AdvancedMarkerElement. Không có sẵn trên addEventListener().
gmp-click	function(event) Đối số:  event:  AdvancedMarkerClickEvent Sự kiện này được kích hoạt khi người dùng nhấp vào phần tử AdvancedMarkerElement. Nên dùng với addEventListener() (thay vì addListener()).

Giao diện AdvancedMarkerElementOptions

google.maps.marker.AdvancedMarkerElementOptionsgiao diện

Các lựa chọn để tạo một AdvancedMarkerElement.

Thuộc tính
collisionBehavior optional	Loại:  CollisionBehavior optional Một kiểu liệt kê chỉ định cách AdvancedMarkerElement hoạt động khi xung đột với một AdvancedMarkerElement khác hoặc với nhãn bản đồ cơ sở trên bản đồ vectơ. Lưu ý: Xung đột AdvancedMarkerElement với AdvancedMarkerElement hoạt động trên cả bản đồ raster và bản đồ vectơ, tuy nhiên, xung đột AdvancedMarkerElement với nhãn của bản đồ cơ sở chỉ hoạt động trên bản đồ vectơ.
content optional	Loại:  Node optional Mặc định: PinElement.element Phần tử DOM hỗ trợ hình ảnh của một AdvancedMarkerElement. Lưu ý: AdvancedMarkerElement không sao chép phần tử DOM được truyền vào. Sau khi phần tử DOM được truyền đến một AdvancedMarkerElement, việc truyền cùng một phần tử DOM đến một AdvancedMarkerElement khác sẽ di chuyển phần tử DOM và khiến AdvancedMarkerElement trước đó trông trống rỗng.
gmpClickable optional	Loại:  boolean optional Mặc định: false Nếu true, AdvancedMarkerElement sẽ có thể nhấp vào và kích hoạt sự kiện gmp-click, đồng thời có thể tương tác cho mục đích hỗ trợ tiếp cận (ví dụ: cho phép thao tác di chuyển bằng bàn phím thông qua các phím mũi tên).
gmpDraggable optional	Loại:  boolean optional Mặc định: false Nếu là true, bạn có thể kéo AdvancedMarkerElement. Lưu ý: Bạn không thể kéo AdvancedMarkerElement có độ cao.
map optional	Loại:  Map optional Bản đồ để hiển thị AdvancedMarkerElement. Bản đồ bắt buộc phải hiển thị AdvancedMarkerElement và có thể được cung cấp bằng cách đặt AdvancedMarkerElement.map nếu không được cung cấp tại cấu trúc.
position optional	Loại:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Đặt vị trí của AdvancedMarkerElement. AdvancedMarkerElement có thể được tạo mà không có vị trí, nhưng sẽ không hiển thị cho đến khi vị trí của nó được cung cấp – ví dụ: theo hành động hoặc lựa chọn của người dùng. Bạn có thể cung cấp vị trí của AdvancedMarkerElement bằng cách đặt AdvancedMarkerElement.position nếu không cung cấp tại thời điểm tạo. Lưu ý: AdvancedMarkerElement có độ cao chỉ được hỗ trợ trên bản đồ vectơ.
title optional	Loại:  string optional Văn bản khi di chuột. Nếu được cung cấp, văn bản hỗ trợ tiếp cận (ví dụ: để sử dụng với trình đọc màn hình) sẽ được thêm vào AdvancedMarkerElement bằng giá trị được cung cấp.
zIndex optional	Loại:  number optional Tất cả AdvancedMarkerElement đều xuất hiện trên bản đồ theo thứ tự zIndex, với các giá trị cao hơn xuất hiện trước các AdvancedMarkerElement có giá trị thấp hơn. Theo mặc định, các AdvancedMarkerElement sẽ xuất hiện theo vị trí dọc trên màn hình, với các AdvancedMarkerElement thấp hơn xuất hiện ở phía trước các AdvancedMarkerElement ở xa hơn trên màn hình. Xin lưu ý rằng zIndex cũng được dùng để xác định mức độ ưu tiên tương đối giữa các điểm đánh dấu nâng cao CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY. Giá trị zIndex càng cao thì mức độ ưu tiên càng cao.

Lớp AdvancedMarkerClickEvent

Lớp google.maps.marker.AdvancedMarkerClickEvent

Sự kiện này được tạo khi người dùng nhấp vào một Điểm đánh dấu nâng cao. Truy cập vào vị trí của điểm đánh dấu bằng event.target.position.

Lớp này mở rộng Event.

Truy cập bằng cách gọi const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker").
Xem Thư viện trong Maps JavaScript API.

Lớp PinElement

Lớp google.maps.marker.PinElement

PinElement đại diện cho một phần tử DOM bao gồm một hình dạng và một ký tự. Hình dạng này có cùng kiểu bóng như trong AdvancedMarkerElement mặc định. Glyph là một phần tử DOM không bắt buộc, xuất hiện ở dạng hình quả bóng. PinElement có thể có tỷ lệ khung hình khác nhau tuỳ thuộc vào PinElement.scale.

Lưu ý: Chúng tôi hiện chưa hỗ trợ việc sử dụng dưới dạng Thành phần web (ví dụ: sử dụng dưới dạng một lớp con HTMLElement hoặc thông qua HTML).

Lớp này mở rộng HTMLElement.

Lớp này triển khai PinElementOptions.

Truy cập bằng cách gọi const {PinElement} = await google.maps.importLibrary("marker").
Xem Thư viện trong Maps JavaScript API.

Phương thức
addEventListener	addEventListener(type, listener[, options]) Tham số:  type:  string listener:  EventListener|EventListenerObject options:  boolean|AddEventListenerOptions optional Giá trị trả về:  void Bạn chưa thể sử dụng chức năng này.
removeEventListener	removeEventListener(type, listener[, options]) Tham số:  type:  string Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện. listener:  EventListener|EventListenerObject Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện. options:  boolean|EventListenerOptions optional Xem các lựa chọn. Giá trị trả về:  void Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện PinElementOptions

google.maps.marker.PinElementOptionsgiao diện

Các lựa chọn để tạo PinElement.