Lớp AdvancedMarkerElement
Lớp google.maps.marker.AdvancedMarkerElement
Hiển thị một vị trí trên bản đồ. Lưu ý rằng bạn phải thiết lập position
thì AdvancedMarkerElement
mới xuất hiện.
Lưu ý: Sử dụng dưới dạng Thành phần web (ví dụ: sử dụng phần tử HTML <gmp-advanced-marker>
tuỳ chỉnh chỉ có trong kênh v=beta
).
Phần tử tuỳ chỉnh:
<gmp-advanced-marker position="lat,lng" title="string"></gmp-advanced-marker>
Lớp này mở rộng HTMLElement
.
Lớp này sẽ 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 API JavaScript Maps.
Hàm dựng | |
---|---|
AdvancedMarkerElement |
AdvancedMarkerElement([options]) Các thông số:
Tạo AdvancedMarkerElement với các tuỳ chọn được chỉ định. Nếu một bản đồ được chỉ định, thì AdvancedMarkerElement sẽ được thêm vào bản đồ trong quá trình xây dựng. |
Thuộc tính | |
---|---|
collisionBehavior |
Loại:
CollisionBehavior optional Vui lòng xem AdvancedMarkerElementOptions.collisionBehavior . |
content |
Loại:
Node optional Vui lòng xem AdvancedMarkerElementOptions.content . |
element |
Loại:
HTMLElement Trường này chỉ để đọc. Phần tử DOM đang sao lưu khung hiển thị. |
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:
|
title |
Loại:
string Vui lòng xem
AdvancedMarkerElementOptions.title .Thuộc tính HTML:
|
zIndex |
Loại:
number optional Vui lòng xem AdvancedMarkerElementOptions.zIndex . |
Phương thức | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Các thông số:
Giá trị trả về:
void Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện đã chỉ định được phân phối đến mục tiêu. Hãy xem addEventListener |
addListener |
addListener(eventName, handler) Các thông số:
Giá trị trả về:
MapsEventListener Trình nghe sự kiện kết quả.Thêm hàm trình nghe đã cho vào tên sự kiện đã cho trong hệ thống Sự kiện Maps. |
removeEventListener |
removeEventListener(type, listener[, options]) Các thông số:
Giá trị trả về:
void Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi mục tiêu. Xem removeEventListener |
Sự kiện | |
---|---|
click |
function(event) Đối số:
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() (hãy dùng gmp-click ). |
drag |
function(event) Đối số:
Sự kiện này được kích hoạt liên tục trong khi người dùng kéo AdvancedMarkerElement .Không dùng được với addEventListener() . |
dragend |
function(event) Đối số:
Sự kiện này được kích hoạt khi người dùng ngừng kéo AdvancedMarkerElement .Không dùng được với addEventListener() . |
dragstart |
function(event) Đối số:
Sự kiện này được kích hoạt khi người dùng bắt đầu kéo AdvancedMarkerElement .Không dùng được với addEventListener() . |
gmp-click |
function(event) Đối số:
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
Giao diện google.maps.marker.AdvancedMarkerElementOptions
Các tuỳ chọn để tạo AdvancedMarkerElement
.
Thuộc tính | |
---|---|
collisionBehavior optional |
Loại:
CollisionBehavior optional Một bản liệt kê chỉ định cách AdvancedMarkerElement sẽ hoạt động khi nó xung đột với AdvancedMarkerElement khác hoặc với các nhãn bản đồ cơ sở trên bản đồ vectơ. Lưu ý: Xung đột |
content optional |
Loại:
Node optional Mặc định:
PinElement.element Phần tử DOM sao lưu hình ảnh của AdvancedMarkerElement . Lưu ý: |
gmpDraggable optional |
Loại:
boolean optional Mặc định:
false Nếu true , bạn có thể kéo AdvancedMarkerElement . Lưu ý: Bạn không thể kéo |
map optional |
Loại:
Map optional Bản đồ mà trên đó hiển thị AdvancedMarkerElement . Bản đồ cần 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 quá trình xây dựng. |
position optional |
Loại:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Thiết lập vị trí của AdvancedMarkerElement . Có thể tạo AdvancedMarkerElement 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ụ: do 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 được cung cấp tại quá trình xây dựng. Lưu ý: |
title optional |
Loại:
string optional Văn bản di chuột qua. 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 với 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, còn giá trị nào càng cao thì càng xuất hiện trước AdvancedMarkerElement và có giá trị thấp hơn. Theo mặc định, AdvancedMarkerElement hiển thị theo vị trí dọc trên màn hình, trong đó AdvancedMarkerElement thấp hơn xuất hiện trước AdvancedMarkerElement phía 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 bằng cách 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 API JavaScript Maps.
Lớp PinElement
Lớp google.maps.marker.PinElement
PinElement
đại diện cho một phần tử DOM bao gồm hình dạng và một ký tự. Hình dạng có cùng kiểu bong bóng như trong AdvancedMarkerElement
mặc định. Ký tự là một phần tử DOM không bắt buộc được hiển thị trong hình bong bóng. PinElement
có thể có tỷ lệ khung hình khác tuỳ thuộc vào PinElement.scale
.
Lưu ý: Chưa hỗ trợ sử dụng làm Thành phần web (ví dụ: sử dụng làm lớp con HTMLElement hoặc thông qua HTML).
Lớp này mở rộng HTMLElement
.
Lớp này sẽ 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 API JavaScript Maps.
Hàm dựng | |
---|---|
PinElement |
PinElement([options]) Các thông số:
|
Thuộc tính | |
---|---|
background |
Loại:
string optional Vui lòng xem PinElementOptions.background . |
borderColor |
Loại:
string optional Vui lòng xem PinElementOptions.borderColor . |
element |
Loại:
HTMLElement Trường này chỉ để đọc. Phần tử DOM đang sao lưu khung hiển thị. |
glyph |
Vui lòng xem PinElementOptions.glyph . |
glyphColor |
Loại:
string optional Vui lòng xem PinElementOptions.glyphColor . |
scale |
Loại:
number optional Vui lòng xem PinElementOptions.scale . |
Phương thức | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Các thông số:
Giá trị trả về:
void Chức năng này chưa có sẵn để sử dụng. |
removeEventListener |
removeEventListener(type, listener[, options]) Các thông số:
Giá trị trả về:
void Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi mục tiêu. Xem removeEventListener |
Giao diện PinElementOptions
Giao diện google.maps.marker.PinElementOptions
Các tuỳ chọn để tạo PinElement
.
Thuộc tính | |
---|---|
background optional |
Loại:
string optional Màu nền của hình ghim. Hỗ trợ mọi giá trị màu của CSS. |
borderColor optional |
Loại:
string optional Màu đường viền của hình dạng ghim. Hỗ trợ mọi giá trị màu của CSS. |
glyph optional |
Phần tử DOM hiển thị trong ghim. |
glyphColor optional |
Loại:
string optional Màu của ký tự. Hỗ trợ mọi giá trị màu của CSS. |
scale optional |
Loại:
number optional Mặc định:
1 Tỷ lệ của ghim. |