Lớp Marker
Lớp google.maps.Marker
Lớp này mở rộng MVCObject
.
Truy cập bằng cách gọi const {Marker} = await google.maps.importLibrary("marker")
.
Xem Thư viện trong Maps JavaScript API.
Hàm dựng | |
---|---|
Marker |
Marker([opts]) Tham số:
Tạo một điểm đánh dấu bằng các lựa chọn đã chỉ định. Nếu bạn chỉ định một bản đồ, thì điểm đánh dấu sẽ được thêm vào bản đồ khi tạo. Xin lưu ý rằng bạn phải đặt vị trí thì điểm đánh dấu mới xuất hiện. |
Hằng số | |
---|---|
MAX_ZINDEX |
Chỉ mục z mặc định tối đa mà API sẽ chỉ định cho một điểm đánh dấu. Bạn có thể đặt chỉ mục z cao hơn để đưa một điểm đánh dấu lên phía trước. |
Phương thức | |
---|---|
getAnimation |
getAnimation() Tham số: Không có
Giá trị trả về:
Animation|null|undefined Lấy ảnh động hiện đang chạy. |
getClickable |
getClickable() Tham số: Không có
Giá trị trả về:
boolean True nếu có thể nhấp vào Điểm đánh dấu.Lấy trạng thái có thể nhấp của Marker . |
getCursor |
getCursor() Tham số: Không có
Giá trị trả về:
string|null|undefined Lấy loại con trỏ chuột xuất hiện khi di chuột. |
getDraggable |
getDraggable() Tham số: Không có
Giá trị trả về:
boolean True nếu Marker có thể kéo.Lấy trạng thái có thể kéo của Marker . |
getIcon |
getIcon() Tham số: Không có
Lấy biểu tượng của Marker . Vui lòng xem MarkerOptions.icon . |
getLabel |
getLabel() Tham số: Không có
Giá trị trả về:
MarkerLabel|string|null|undefined Lấy nhãn của Marker . Vui lòng xem MarkerOptions.label . |
getMap |
getMap() Tham số: Không có
Giá trị trả về:
Map|StreetViewPanorama Lấy bản đồ hoặc ảnh toàn cảnh mà Marker được kết xuất trên đó. |
getOpacity |
getOpacity() Tham số: Không có
Giá trị trả về:
number|null|undefined Một số từ 0,0 đến 1,0.Lấy độ mờ của Marker . |
getPosition |
getPosition() Tham số: Không có
Giá trị trả về:
LatLng|null|undefined Lấy vị trí của Marker . |
getShape |
getShape() Tham số: Không có
Giá trị trả về:
MarkerShape|null|undefined |
getTitle |
getTitle() Tham số: Không có
Giá trị trả về:
string|null|undefined Lấy tiêu đề của chú thích Marker . Vui lòng xem MarkerOptions.title . |
getVisible |
getVisible() Tham số: Không có
Giá trị trả về:
boolean True nếu Điểm đánh dấu hiển thị.Nhận thông tin về khả năng hiển thị của Marker . |
getZIndex |
getZIndex() Tham số: Không có
Giá trị trả về:
number|null|undefined zIndex của điểm đánh dấu.Lấy zIndex của Marker . Vui lòng xem MarkerOptions.zIndex . |
setAnimation |
setAnimation([animation]) Tham số:
Giá trị trả về: Không có
Bắt đầu một ảnh động. Mọi ảnh động đang diễn ra sẽ bị huỷ. Ảnh động hiện được hỗ trợ là: Animation.BOUNCE , Animation.DROP . Truyền vào null sẽ khiến mọi ảnh động dừng lại. |
setClickable |
setClickable(flag) Tham số:
Giá trị trả về: Không có
Đặt xem Marker có thể nhấp vào hay không. |
setCursor |
setCursor([cursor]) Tham số:
Giá trị trả về: Không có
Đặt loại con trỏ chuột xuất hiện khi di chuột. |
setDraggable |
setDraggable(flag) Tham số:
Giá trị trả về: Không có
Đặt xem Marker có thể kéo hay không. |
setIcon |
setIcon([icon]) Giá trị trả về: Không có
Đặt biểu tượng cho Marker . Vui lòng xem MarkerOptions.icon . |
setLabel |
setLabel([label]) Tham số:
Giá trị trả về: Không có
Đặt nhãn cho Marker . Vui lòng xem MarkerOptions.label . |
setMap |
setMap(map) Tham số:
Giá trị trả về: Không có
Kết xuất Marker trên bản đồ hoặc ảnh toàn cảnh được chỉ định. Nếu bạn đặt bản đồ thành null , điểm đánh dấu sẽ bị xoá. |
setOpacity |
setOpacity([opacity]) Tham số:
Giá trị trả về: Không có
Đặt độ mờ của Marker . |
setOptions |
setOptions(options) Tham số:
Giá trị trả về: Không có
Đặt các lựa chọn cho Marker . |
setPosition |
setPosition([latlng]) Tham số:
Giá trị trả về: Không có
Đặt vị trí cho Marker . |
setShape |
setShape([shape]) Tham số:
Giá trị trả về: Không có
|
setTitle |
setTitle([title]) Tham số:
Giá trị trả về: Không có
Đặt tiêu đề cho chú giải công cụ Marker . Vui lòng xem MarkerOptions.title . |
setVisible |
setVisible(visible) Tham số:
Giá trị trả về: Không có
Đặt xem Marker có hiển thị hay không. |
setZIndex |
setZIndex([zIndex]) Tham số:
Giá trị trả về: Không có
Đặt zIndex của Marker . Vui lòng xem MarkerOptions.zIndex . |
Kế thừa:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Sự kiện | |
---|---|
animation_changed |
function() Đối số: Không có
Sự kiện này sẽ kích hoạt khi thuộc tính ảnh động Marker thay đổi. |
click |
function(event) Đối số:
Sự kiện này được kích hoạt khi người dùng nhấp vào biểu tượng Marker . |
clickable_changed |
function() Đối số: Không có
Sự kiện này sẽ kích hoạt khi thuộc tính có thể nhấp Marker thay đổi. |
contextmenu |
function(event) Đối số:
Sự kiện này được kích hoạt khi sự kiện DOM contextmenu được kích hoạt trên Marker |
cursor_changed |
function() Đối số: Không có
Sự kiện này sẽ kích hoạt khi thuộc tính con trỏ Marker thay đổi. |
dblclick |
function(event) Đối số:
Sự kiện này được kích hoạt khi biểu tượng Marker được nhấp đúp. |
drag |
function(event) Đối số:
Sự kiện này được kích hoạt nhiều lần trong khi người dùng kéo Marker . |
dragend |
function(event) Đối số:
Sự kiện này được kích hoạt khi người dùng ngừng kéo Marker . |
draggable_changed |
function() Đối số: Không có
Sự kiện này sẽ kích hoạt khi thuộc tính có thể kéo Marker thay đổi. |
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 Marker . |
flat_changed |
function() Đối số: Không có
Sự kiện này sẽ kích hoạt khi thuộc tính Marker phẳng thay đổi. |
icon_changed |
function() Đối số: Không có
Sự kiện này sẽ kích hoạt khi thuộc tính biểu tượng Marker thay đổi. |
mousedown |
function(event) Đối số:
Sự kiện này được kích hoạt khi người dùng nhấp chuột vào Marker . |
mouseout |
function(event) Đối số:
Sự kiện này được kích hoạt khi chuột rời khỏi khu vực của biểu tượng Marker . |
mouseover |
function(event) Đối số:
Sự kiện này được kích hoạt khi chuột di chuyển vào vùng của biểu tượng Marker . |
mouseup |
function(event) Đối số:
Sự kiện này được kích hoạt khi người dùng nhả chuột trên Marker . |
position_changed |
function() Đối số: Không có
Sự kiện này sẽ kích hoạt khi thuộc tính vị trí Marker thay đổi. |
shape_changed |
function() Đối số: Không có
Sự kiện này sẽ kích hoạt khi thuộc tính hình dạng Marker thay đổi. |
title_changed |
function() Đối số: Không có
Sự kiện này được kích hoạt khi thuộc tính tiêu đề Marker thay đổi. |
visible_changed |
function() Đối số: Không có
Sự kiện này sẽ kích hoạt khi thuộc tính Marker visible thay đổi. |
zindex_changed |
function() Đối số: Không có
Sự kiện này sẽ kích hoạt khi thuộc tính Marker zIndex thay đổi. |
|
function(event) Đối số:
Sự kiện này được kích hoạt khi người dùng nhấp chuột phải vào Marker . |
Giao diện MarkerOptions
google.maps.MarkerOptions
giao diện
Đối tượng MarkerOptions dùng để xác định các thuộc tính có thể được đặt trên một Marker.
Thuộc tính | |
---|---|
anchorPoint optional |
Loại:
Point optional Độ lệch từ vị trí của điểm đánh dấu đến đầu của một InfoWindow đã được mở bằng điểm đánh dấu làm điểm neo. |
animation optional |
Loại:
Animation optional Mặc định:
null Ảnh động nào sẽ phát khi điểm đánh dấu được thêm vào bản đồ. |
clickable optional |
Loại:
boolean optional Mặc định:
true Nếu true , điểm đánh dấu sẽ nhận được các sự kiện về chuột và thao tác chạm. |
|
Loại:
string|CollisionBehavior optional Mặc định:
null Đặt hành vi va chạm cho các điểm đánh dấu trên bản đồ vectơ. |
crossOnDrag optional |
Loại:
boolean optional Mặc định:
true Nếu false , hãy tắt dấu thập xuất hiện bên dưới điểm đánh dấu khi kéo. |
cursor optional |
Loại:
string optional Mặc định:
pointer Loại con trỏ chuột sẽ xuất hiện khi di chuột. |
draggable optional |
Loại:
boolean optional Mặc định:
false Nếu true , bạn có thể kéo điểm đánh dấu. Lưu ý: Nếu bạn đặt giá trị này thành true , điểm đánh dấu sẽ có thể nhấp vào ngay cả khi clickable được đặt thành false . |
icon optional |
Biểu tượng cho nền trước. Nếu một chuỗi được cung cấp, thì chuỗi đó sẽ được coi như thể là một Icon có chuỗi là url . |
label optional |
Loại:
string|MarkerLabel optional Mặc định:
null Thêm nhãn vào điểm đánh dấu. Nhãn điểm đánh dấu là một chữ cái hoặc số xuất hiện bên trong điểm đánh dấu. Nhãn có thể là một chuỗi hoặc một đối tượng MarkerLabel . Nếu bạn cung cấp và không cung cấp MarkerOptions.title , thì văn bản hỗ trợ tiếp cận (ví dụ: để dùng với trình đọc màn hình) sẽ được thêm vào điểm đánh dấu bằng văn bản của nhãn được cung cấp. Xin lưu ý rằng label hiện chỉ được dùng cho văn bản hỗ trợ tiếp cận của các điểm đánh dấu không được tối ưu hoá. |
map optional |
Loại:
Map|StreetViewPanorama optional Bản đồ để hiển thị Điểm đánh dấu. Bạn phải có bản đồ để hiển thị điểm đánh dấu và có thể cung cấp bản đồ bằng Marker.setMap nếu không cung cấp khi tạo điểm đánh dấu. |
opacity optional |
Loại:
number optional Mặc định: 1.0
Một số từ 0,0 (trong suốt) đến 1,0 (mờ). |
optimized optional |
Loại:
boolean optional Việc tối ưu hoá giúp nâng cao hiệu suất bằng cách kết xuất nhiều điểm đánh dấu dưới dạng một phần tử tĩnh duy nhất. Điều này hữu ích trong trường hợp bạn cần một số lượng lớn điểm đánh dấu. Đọc thêm về tối ưu hoá điểm đánh dấu. Lưu ý: Việc tối ưu hoá này không ảnh hưởng đến các điểm đánh dấu trên bản đồ vectơ. |
position optional |
Loại:
LatLng|LatLngLiteral optional Đặt vị trí điểm đánh dấu. Bạn có thể tạo một điểm đánh dấu nhưng điểm này sẽ không xuất hiện cho đến khi bạn cung cấp vị trí của điểm đánh dấu (ví dụ: thông qua 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 điểm đánh dấu bằng Marker.setPosition nếu không cung cấp khi tạo điểm đánh dấu. |
shape optional |
Loại:
MarkerShape optional Định nghĩa khu vực bản đồ hình ảnh dùng cho thao tác kéo/nhấp. |
title optional |
Loại:
string optional Mặc định:
undefined 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 điểm đánh dấu cùng với giá trị được cung cấp. Xin lưu ý rằng title hiện chỉ được dùng cho văn bản hỗ trợ tiếp cận của các điểm đánh dấu không được tối ưu hoá. |
visible optional |
Loại:
boolean optional Mặc định:
true Nếu true , điểm đánh dấu sẽ xuất hiện. |
zIndex optional |
Loại:
number optional Tất cả các điểm đánh dấu đều xuất hiện trên bản đồ theo thứ tự zIndex, với các giá trị cao hơn sẽ xuất hiện trước các điểm đánh dấu có giá trị thấp hơn. Theo mặc định, các điểm đánh dấu sẽ xuất hiện theo vị trí dọc trên màn hình, trong đó các điểm đánh dấu ở vị trí thấp hơn sẽ xuất hiện trước các điểm đánh dấu ở vị trí cao hơn trên màn hình. |
Hằng số CollisionBehavior
Hằng số google.maps.CollisionBehavior
Truy cập bằng cách gọi const {CollisionBehavior} = await google.maps.importLibrary("marker")
.
Xem Thư viện trong Maps JavaScript API.
Hằng số | |
---|---|
OPTIONAL_AND_HIDES_LOWER_PRIORITY |
Chỉ hiển thị điểm đánh dấu nếu điểm đó không trùng 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ì thành phần có vị trí dọc thấp hơn trên màn hình sẽ xuất hiện. |
REQUIRED |
Luôn hiển thị điểm đánh dấu bất kể có xảy ra xung đột hay không. Đây là hành vi mặc định. |
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, đồng thời ẩn mọi điểm đánh dấu hoặc nhãn OPTIONAL_AND_HIDES_LOWER_PRIORITY có thể trùng lặp với điểm đánh dấu này. |
Giao diện Biểu tượng
google.maps.Icon
giao diện
Một cấu trúc đại diện cho hình ảnh biểu tượng Marker.
Thuộc tính | |
---|---|
url |
Loại:
string URL của hình ảnh hoặc bảng kết hợp hình ảnh. |
anchor optional |
Loại:
Point optional Vị trí để cố định hình ảnh tương ứng với vị trí của điểm đánh dấu trên bản đồ. Theo mặc định, điểm neo nằm dọc theo điểm chính giữa ở cuối hình ảnh. |
labelOrigin optional |
Loại:
Point optional Nguồn gốc của nhãn so với góc trên cùng bên trái của hình ảnh biểu tượng, nếu điểm đánh dấu cung cấp nhãn. Theo mặc định, điểm gốc nằm ở tâm của hình ảnh. |
origin optional |
Loại:
Point optional Vị trí của hình ảnh trong một sprite (nếu có). Theo mặc định, gốc toạ độ nằm ở góc trên cùng bên trái của hình ảnh (0, 0) . |
scaledSize optional |
Loại:
Size optional Kích thước của toàn bộ hình ảnh sau khi được điều chỉnh tỷ lệ (nếu có). Sử dụng thuộc tính này để kéo giãn/thu nhỏ hình ảnh hoặc sprite. |
size optional |
Loại:
Size optional Kích thước hiển thị của hình ảnh hoặc sprite. Khi sử dụng sprite, bạn phải chỉ định kích thước sprite. Nếu bạn không cung cấp kích thước, thì kích thước sẽ được đặt khi hình ảnh tải. |
Giao diện MarkerLabel
google.maps.MarkerLabel
giao diện
Các lựa chọn này chỉ định giao diện của nhãn điểm đánh dấu. Nhãn điểm đánh dấu là một chuỗi (thường là một ký tự) sẽ xuất hiện bên trong điểm đánh dấu. Nếu đang dùng với một điểm đánh dấu tuỳ chỉnh, bạn có thể định vị lại điểm đánh dấu đó bằng thuộc tính labelOrigin
trong lớp Icon
.
Thuộc tính | |
---|---|
text |
Loại:
string Văn bản sẽ xuất hiện trong nhãn. |
className optional |
Loại:
string optional Mặc định:
'' (chuỗi trống)Thuộc tính className của phần tử nhãn (tương đương với thuộc tính class của phần tử). Bạn có thể thêm nhiều lớp CSS được phân tách bằng dấu cách. Bạn chỉ có thể đặt màu, kích thước, độ đậm và họ phông chữ thông qua các thuộc tính khác của MarkerLabel . Bạn không nên dùng các lớp CSS để thay đổi vị trí hoặc hướng của nhãn (ví dụ: dùng bản dịch và xoay) nếu cũng dùng tính năng quản lý xung đột điểm đánh dấu. |
color optional |
Loại:
string optional Mặc định:
'black' Màu của văn bản nhãn. |
fontFamily optional |
Loại:
string optional Bộ phông chữ của văn bản nhãn (tương đương với thuộc tính font-family của CSS). |
fontSize optional |
Loại:
string optional Mặc định:
'14px' Cỡ chữ của văn bản nhãn (tương đương với thuộc tính font-size của CSS). |
fontWeight optional |
Loại:
string optional Độ đậm của văn bản nhãn (tương đương với thuộc tính font-weight của CSS). |
Giao diện MarkerShape
google.maps.MarkerShape
giao diện
Đối tượng này xác định vùng có thể nhấp của hình ảnh điểm đánh dấu. Hình dạng này bao gồm 2 thuộc tính – type
và coord
– giúp xác định vùng không trong suốt của hình ảnh.
Thuộc tính | |
---|---|
type |
Loại:
string Mô tả loại hình dạng và có thể là circle , poly hoặc rect . |
coords optional |
Loại:
Array<number> optional Định dạng của thuộc tính này phụ thuộc vào giá trị của type và tuân theo quy cách coords AREA w3 có tại http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords. Thuộc tính coords là một mảng số nguyên chỉ định vị trí pixel của hình dạng so với góc trên cùng bên trái của hình ảnh mục tiêu. Toạ độ phụ thuộc vào giá trị của type như sau: – circle : coords là [x1,y1,r] trong đó x1, y2 là toạ độ của tâm đường tròn và r là bán kính của đường tròn. – poly : coords là [x1,y1,x2,y2...xn,yn] , trong đó mỗi cặp x,y chứa toạ độ của một đỉnh của đa giác. – rect : coords là [x1,y1,x2,y2] trong đó x1,y1 là toạ độ của góc trên bên trái của hình chữ nhật và x2,y2 là toạ độ của góc dưới bên phải của hình chữ nhật. |
Giao diện Symbol
google.maps.Symbol
giao diện
Mô tả một biểu tượng, bao gồm một đường dẫn vectơ có kiểu. Bạn có thể dùng một biểu tượng làm biểu tượng của điểm đánh dấu hoặc đặt trên một đường nhiều đoạn.
Thuộc tính | |
---|---|
path |
Loại:
SymbolPath|string Đường dẫn của biểu tượng, là đường dẫn biểu tượng tích hợp hoặc đường dẫn tuỳ chỉnh được biểu thị bằng ký hiệu đường dẫn SVG. Bắt buộc. |
anchor optional |
Loại:
Point optional Mặc định:
google.maps.Point(0,0) Vị trí của biểu tượng so với điểm đánh dấu hoặc đường nhiều đường. Toạ độ của đường dẫn biểu tượng được dịch sang trái và lên trên theo toạ độ x và y của điểm neo tương ứng. Vị trí được biểu thị trong cùng hệ toạ độ với đường dẫn của biểu tượng. |
fillColor optional |
Loại:
string optional Màu nền của biểu tượng. Tất cả các màu CSS3 đều được hỗ trợ, ngoại trừ các màu có tên mở rộng. Đối với điểm đánh dấu biểu tượng, giá trị này mặc định là "black" (màu đen). Đối với các biểu tượng trên đường nhiều đường, giá trị này mặc định là màu nét vẽ của đường nhiều đường tương ứng. |
fillOpacity optional |
Loại:
number optional Mặc định:
0 Độ mờ của màu tô biểu tượng. |
labelOrigin optional |
Loại:
Point optional Mặc định:
google.maps.Point(0,0) Nguồn gốc của nhãn so với nguồn gốc của đường dẫn, nếu nhãn do điểm đánh dấu cung cấp. Nguồn gốc được biểu thị trong cùng hệ toạ độ với đường dẫn của biểu tượng. Thuộc tính này không được dùng cho các biểu tượng trên đường nhiều đoạn. |
rotation optional |
Loại:
number optional Mặc định:
0 Góc xoay biểu tượng, được biểu thị theo chiều kim đồng hồ bằng độ. Một biểu tượng trong IconSequence , trong đó fixedRotation là false được xoay tương ứng với góc của cạnh mà biểu tượng đó nằm trên. |
scale optional |
Loại:
number optional Lượng mà biểu tượng được điều chỉnh kích thước. Đối với các điểm đánh dấu bằng biểu tượng, giá trị này mặc định là 1; sau khi được điều chỉnh tỷ lệ, biểu tượng có thể có kích thước bất kỳ. Đối với các biểu tượng trên một đường nhiều đoạn, giá trị này mặc định là trọng số nét của đường nhiều đoạn; sau khi điều chỉnh tỷ lệ, biểu tượng phải nằm trong một hình vuông có kích thước 22 pixel được căn giữa tại điểm neo của biểu tượng. |
strokeColor optional |
Loại:
string optional Màu nét vẽ của biểu tượng. Tất cả các màu CSS3 đều được hỗ trợ, ngoại trừ các màu có tên mở rộng. Đối với điểm đánh dấu biểu tượng, giá trị này mặc định là "black" (màu đen). Đối với các biểu tượng trên một đường nhiều đoạn, giá trị này mặc định là màu nét của đường nhiều đoạn. |
strokeOpacity optional |
Loại:
number optional Độ mờ của nét vẽ biểu tượng. Đối với điểm đánh dấu biểu tượng, giá trị này mặc định là 1. Đối với các biểu tượng trên một đường nhiều đoạn, giá trị này mặc định là độ mờ của nét vẽ của đường nhiều đoạn. |
strokeWeight optional |
Loại:
number optional Mặc định:
Symbol.scale của biểu tượng.Độ đậm của nét biểu tượng. |
Hằng số SymbolPath
Hằng số google.maps.SymbolPath
Đường dẫn biểu tượng tích hợp sẵn.
Truy cập bằng cách gọi const {SymbolPath} = await google.maps.importLibrary("core")
.
Xem Thư viện trong Maps JavaScript API.
Hằng số | |
---|---|
BACKWARD_CLOSED_ARROW |
Một mũi tên khép kín chỉ về phía sau. |
BACKWARD_OPEN_ARROW |
Một mũi tên hở chỉ về phía sau. |
CIRCLE |
Một vòng tròn. |
FORWARD_CLOSED_ARROW |
Một mũi tên khép kín chỉ về phía trước. |
FORWARD_OPEN_ARROW |
Một mũi tên mở chỉ về phía trước. |
Hằng số Ảnh động
Hằng số google.maps.Animation
Ảnh động có thể phát trên một điểm đánh dấu. Sử dụng phương thức Marker.setAnimation
trên Marker hoặc lựa chọn MarkerOptions.animation
để phát một ảnh động.
Truy cập bằng cách gọi const {Animation} = await google.maps.importLibrary("marker")
.
Xem Thư viện trong Maps JavaScript API.
Hằng số | |
---|---|
BOUNCE |
Điểm đánh dấu sẽ bật lên cho đến khi ảnh động dừng lại bằng cách gọi Marker.setAnimation bằng null . |
DROP |
Điểm đánh dấu thả từ đầu bản đồ xuống vị trí cuối cùng. Ảnh động sẽ dừng khi điểm đánh dấu dừng lại và Marker.getAnimation sẽ trả về null . Loại ảnh động này thường được chỉ định trong quá trình tạo điểm đánh dấu. |