Marker

Lớp Marker

Lớp google.maps.Marker

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

Marker
Marker([opts])
Thông số:
  • opts: MarkerOptions optional Các đối số tùy chọn được đặt tên
Tạo điểm đánh dấu với các tùy chọn được chỉ định. Nếu một bản đồ được chỉ định, điểm đánh dấu sẽ được thêm vào bản đồ khi xây dựng. Lưu ý rằng vị trí phải được đặt để điểm đánh dấu hiển thị.
getAnimation
getAnimation()
Thông số: Không có
Giá trị trả về: Animation|null|undefined
Tải ảnh động hiện đang chạy.
getClickable
getClickable()
Thông số: Không có
Giá trị trả về: boolean Đúng nếu có Điểm đánh dấu có thể nhấp được.
Nhận trạng thái có thể nhấp của Marker.
getCursor
getCursor()
Thông số: Không có
Giá trị trả về: string|null|undefined
Xem loại con trỏ chuột khi di chuột.
getDraggable
getDraggable()
Thông số: Không có
Giá trị trả về: boolean Đúng nếu có thể kéo điểm đánh dấu.
Nhận trạng thái có thể kéo của Marker.
getIcon
getIcon()
Thông số: Không có
Giá trị trả về: string|Icon|null|Symbol|undefined
Lấy biểu tượng của Marker. Vui lòng xem MarkerOptions.icon.
getLabel
getLabel()
Thông số: Không có
Giá trị trả về: MarkerLabel|null|string|undefined
Lấy nhãn của Marker. Vui lòng xem MarkerOptions.label.
getMap
getMap()
Thông số: Không có
Giá trị trả về: Map|StreetViewPanorama
Lấy bản đồ hoặc ảnh tương tác của Marker được hiển thị.
getOpacity
getOpacity()
Thông số: Không có
Giá trị trả về: number|null|undefined Một số từ 0 đến 1.0.
Lấy độ mờ của Marker.
getPosition
getPosition()
Thông số: Không có
Giá trị trả về: LatLng|null|undefined
Lấy vị trí của Marker.
getShape
getShape()
Thông số: Không có
Giá trị trả về: MarkerShape|null|undefined
Nhận hình dạng của Marker dùng để tương tác. Hãy xem MarkerOptions.shapeMarkerShape.
getTitle
getTitle()
Thông số: Không có
Giá trị trả về: string|null|undefined
Lấy tiêu đề của chú giải công cụ Marker. Vui lòng xem MarkerOptions.title.
getVisible
getVisible()
Thông số: Không có
Giá trị trả về: boolean Đúng nếu có Điểm đánh dấu xuất hiện.
Nhận chế độ hiển thị của Marker.
getZIndex
getZIndex()
Thông 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])
Thông số:
  • animationAnimation optional Ảnh động sẽ phát.
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. Khi bạn chuyển vào null, mọi ảnh động sẽ dừng lại.
setClickable
setClickable(flag)
Thông số:
  • flagboolean Nếu true, Bạn có thể nhấp vào Điểm đánh dấu.
Giá trị trả về: Không có
Thiết lập liệu Marker có thể nhấp được hay không.
setCursor
setCursor([cursor])
Thông số:
  • cursor: string optional Loại con trỏ chuột.
Giá trị trả về: Không có
Đặt loại con trỏ chuột hiển thị khi di chuột.
setDraggable
setDraggable(flag)
Thông số:
  • flag: boolean optional Nếu true, Bạn có thể kéo Điểm đánh dấu.
Giá trị trả về: Không có
Đặt xem Marker có thể kéo được hay không.
setIcon
setIcon([icon])
Thông số:
Giá trị trả về: Không có
Đặt biểu tượng cho Marker. Vui lòng xem MarkerOptions.icon.
setLabel
setLabel([label])
Thông số:
  • labelstring|MarkerLabel optional Nhãn có thể là một chuỗi ký tự hoặc một đối tượng MarkerLabel.
Giá trị trả về: Không có
Đặt nhãn cho Marker. Vui lòng xem MarkerOptions.label.
setMap
setMap(map)
Thông số:
Giá trị trả về: Không có
Hiển thị Marker trên bản đồ hoặc toàn cảnh đã chỉ định. Nếu bạn đặt bản đồ thành null, điểm đánh dấu sẽ bị xóa.
setOpacity
setOpacity([opacity])
Thông số:
  • opacity: number optional Một số từ 0,0, trong suốt đến 1,0, mờ.
Giá trị trả về: Không có
Đặt độ mờ của Marker.
setOptions
setOptions(options)
Thông số:
Giá trị trả về: Không có
Đặt tuỳ chọn cho Marker.
setPosition
setPosition([latlng])
Thông số:
Giá trị trả về: Không có
Đặt tư thế cho Marker.
setShape
setShape([shape])
Thông số:
Giá trị trả về: Không có
Thiết lập hình dạng của Marker dùng để tương tác. Hãy xem MarkerOptions.shapeMarkerShape.
setTitle
setTitle([title])
Thông số:
  • titlestring optional
Giá trị trả về: Không có
Đặt tiêu đề của chú giải công cụ Marker. Vui lòng xem MarkerOptions.title.
setVisible
setVisible(visible)
Thông số:
  • visible: boolean Nếu true, Điểm đánh dấu đang hiển thị
Giá trị trả về: Không có
Đặt xem Marker có hiển thị hay không.
setZIndex
setZIndex([zIndex])
Thông số:
  • zIndexnumber optional
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
MAX_ZINDEX Chỉ mục z tối đa mặc định 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 điểm đánh dấu lên trước.
animation_changed
function()
Đối số: Không có
Sự kiện này được 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 được kích hoạt khi thuộc tính Marker có thể nhấp thay đổi.
contextmenu
function(event)
Đối số:
Sự kiện này được kích hoạt khi sự kiện menu ngữ cảnh DOM được kích hoạt trên Marker
cursor_changed
function()
Đối số: Không có
Sự kiện này được 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 người dùng nhấp đúp vào biểu tượng Marker.
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 được kích hoạt khi thuộc tính kéo được 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 được kích hoạt khi thuộc tính phẳng của Marker thay đổi.
icon_changed
function()
Đối số: Không có
Sự kiện này được 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 di chuột xuống 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 khu vực của biểu tượng Marker.
mouseup
function(event)
Đối số:
Sự kiện này được kích hoạt để di chuột qua Marker.
position_changed
function()
Đối số: Không có
Sự kiện này được 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 được 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 được kích hoạt khi thuộc tính hiển thị của Marker thay đổi.
zindex_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi thuộc tính zIndex Marker thay đổi.
rightclick
function(event)
Đối số:
Sự kiện này được kích hoạt cho một lượt nhấp chuột phải vào Marker.

Giao diện MarkerOptions

Giao diện google.maps.MarkerOptions

Đối tượng MarkOptions được sử dụng để xác định các thuộc tính có thể đặt trên Đánh dấu.

anchorPoint optional
Loại: Point optional
Giá trị chênh lệch từ vị trí của điểm đánh dấu & điểm đánh dấu của đầu Cửa sổ thông tin đã được mở bằng điểm đánh dấu là điểm neo.
animation optional
Loại: Animation optional
Mặc định: null
Hoạt ảnh 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 chuột và chạm.
BetacollisionBehavior optional
Loại: string|CollisionBehavior optional
Mặc định: null
Thiết lập 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 chữ 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ẽ hiển thị 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.
icon optional
Loại: string|Icon|Symbol optional
Biểu tượng cho nền trước. Nếu một chuỗi được cung cấp, thì chuỗi đó được coi là một Icon với 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 đánh dấu là một chữ cái hoặc số xuất hiện bên trong một điểm đánh dấu. Nhãn có thể là một chuỗi hoặc đối tượng MarkerLabel. Nếu bạn cung cấp MarkerOptions.title và không cung cấp văn bản thì 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ó văn bản trên 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 cho các điểm đánh dấu không được tối ưu hoá.
map optional
Loại: Map|StreetViewPanorama optional
Bản đồ sẽ hiển thị Điểm đánh dấu. Bản đồ là bắt buộc để hiển thị điểm đánh dấu và có thể được cung cấp với Marker.setMap nếu không được cung cấp trong quá trình xây dựng đ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
Tính năng tối ưu hoá nâng cao hiệu suất bằng cách hiển thị nhiều điểm đánh dấu dưới dạng một phần tử tĩnh. Điều này rất hữu ích trong trường hợp cần một số lượng lớn các điểm đánh dấu. Đọc thêm về tối ưu hóa điểm đánh dấu.
position optional
Loại: LatLng|LatLngLiteral optional
Đặt vị trí điểm đánh dấu. Một điểm đánh dấu có thể được tạo ra nhưng sẽ không hiển thị cho đến khi vị trí của điểm đánh dấu đó đượ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í điểm đánh dấu bằng Marker.setPosition nếu không được cung cấp trong quá trình tạo điểm đánh dấu.
shape optional
Loại: MarkerShape optional
Định nghĩa vùng bản đồ hình ảnh dùng để kéo/nhấp.
title optional
Loại: string optional
Mặc định: undefined
Cuộn văn bản. 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ó giá trị đã 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 cho 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ẽ hiển thị.
zIndex optional
Loại: number optional
Tất cả các điểm đánh dấu được hiển thị trên bản đồ theo thứ tự zIndex, với các giá trị cao hơn hiển thị phía 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 được hiển thị theo vị trí dọc của chúng trên màn hình, với các điểm đánh dấu thấp hơn xuất hiện phía trước các điểm đánh dấu hơn nữa trên màn hình.

Hằng số CollisionBehavior

Hằng số google.maps.CollisionBehavior

OPTIONAL_AND_HIDES_LOWER_PRIORITY Chỉ hiển thị điểm đánh dấu nếu nó không chồng chéo 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 bị trùng lặp, điểm đánh dấu có zIndex cao hơn sẽ được hiển thị. Nếu các chỉ số đó có cùng zIndex, thì chỉ số này sẽ xuất hiện ở vị trí phía dưới của màn hình.
REQUIRED Luôn hiển thị điểm đánh dấu bất kể va chạm. Đâ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ể xảy ra xung đột và ẩn bất kỳ điểm đánh dấu hoặc nhãn nào OPTIONAL_AND_VISITS_LOWER_PRIORITY sẽ bị trùng lặp với điểm đánh dấu.

Giao diện Icon (Biểu tượng)

Giao diện google.maps.Icon

Cấu trúc đại diện cho hình ảnh biểu tượng Đánh dấu.

url
Loại: string
URL của hình ảnh hoặc bảng sprite.
anchor optional
Loại: Point optional
Vị trí mà tại đó neo hình ảnh trong thư từ vào vị trí của điểm đánh dấu trên bản đồ. Theo mặc định, thẻ neo nằm dọc theo điểm giữa của phần dưới cùng của 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 nhãn được cung cấp bởi điểm đánh dấu. Theo mặc định, điểm gốc nằm ở điểm giữa của hình ảnh.
origin optional
Loại: Point optional
Vị trí của hình ảnh trong tệp sprite, nếu có. Theo mặc định, điểm gốc 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 điều chỉnh theo tỷ lệ (nếu có). Sử dụng thuộc tính này để kéo dài/thu nhỏ hình ảnh hoặc sprite.
size optional
Loại: Size optional
Kích thước hiển thị của sprite hoặc hình ảnh. Khi sử dụng sprite, bạn phải chỉ định kích thước sprite. Nếu kích thước không được cung cấp, nó sẽ được đặt khi hình ảnh tải.

Giao diện MarkerLabel

Giao diện google.maps.MarkerLabel

Những tùy chọn này chỉ định hình dáng của nhãn đánh dấu. Nhãn đá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 sử dụng nó với một điểm đánh dấu tuỳ chỉnh, bạn có thể đặt lại vị trí đó bằng thuộc tính labelOrigin trong lớp Icon.

text
Loại: string
Văn bản sẽ hiển thị 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 lớp 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 phông chữ, kích thước, độ đậm và họ qua các thuộc tính khác của MarkerLabel. Không được dùng các lớp CSS để thay đổi vị trí hoặc hướng của nhãn (ví dụ: sử dụng bản dịch và chế độ xoay) nếu sử dụng cả tính năng quản lý xung đột đá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 phông chữ của phông chữ CSS).
fontSize optional
Loại: string optional
Mặc định: '14px'
Kích thước phông chữ của văn bản nhãn (tương đương với thuộc tính kích thước phông chữ CSS).
fontWeight optional
Loại: string optional
Độ đậm phông chữ của văn bản nhãn (tương đương với thuộc tính độ đậm của phông chữ CSS).

Giao diện MarkerShape

Giao diện google.maps.MarkerShape

Đố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 bao gồm hai thuộc tính — typecoord — xác định vùng không trong suốt của hình ảnh.

coords
Loại: Array<number>
Đị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 đặc tả w3 AREA coords 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 xác đị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: tọa độ là [x1,y1,r],trong đó x1, y2 là tọa độ của tâm của hình tròn và r là bán kính của hình tròn.
poly: tọa độ là [x1,y1,x2,y2...xn,yn], trong đó mỗi cặp x, y chứa tọa độ của một đỉnh của đa giác.
rect: tọa độ là [x1,y1,x2,y2], trong đó x1,y1 là tọa độ của góc trên bên trái của hình chữ nhật và x2,y2 là tọa độ của các tọa độ phía dưới bên phải của hình chữ nhật.
type
Loại: string
Mô tả loại hình dạng và có thể là circle, poly hoặc rect.

Giao diện Symbol (Biểu tượng)

Giao diện google.maps.Symbol

Mô tả một ký hiệu, bao gồm một đường dẫn vectơ có kiểu. Một biểu tượng có thể được dùng làm biểu tượng của một điểm đánh dấu hoặc đặt trên nhiều hình.

path
Loại: SymbolPath|string
Đường dẫn ký hiệu là đường dẫn biểu tượng tích hợp sẵn hoặc đường dẫn tùy 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 tương ứng với điểm đánh dấu hoặc nhiều đường. Tọa độ của đường dẫn của biểu tượng được dịch sang trái và lên theo tọa độ x và y của neo. Vị trí được biểu thị trong cùng một hệ toạ độ như đường đi của biểu tượng.
fillColor optional
Loại: string optional
Màu tô của biểu tượng. Tất cả màu CSS3 đều được hỗ trợ, ngoại trừ màu có tên mở rộng. Đối với các điểm đánh dấu ký hiệu, giá trị này sẽ được đặt mặc định là 'màu đen#39;. Đối với các ký hiệu trên hình nhiều đường, thuộc tính này được mặc định là màu nét vẽ của hình nhiều đường tương ứng.
fillOpacity optional
Loại: number optional
Mặc định: 0
Màu nền của biểu tượng có độ mờ.
labelOrigin optional
Loại: Point optional
Mặc định: google.maps.Point(0,0)
Nguồn gốc của nhãn liên quan đến 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 một hệ toạ độ như đường dẫn của ký hiệu. Thuộc tính này không được sử dụng cho các biểu tượng trên nhiều đường.
rotation optional
Loại: number optional
Mặc định: 0
Góc dùng để xoay biểu tượng, được biểu thị theo chiều kim đồng hồ, theo độ. Một biểu tượng trong IconSequencefixedRotationfalse được xoay tương ứng với góc của cạnh nằm trên đó.
scale optional
Loại: number optional
Số lượng mà biểu tượng được chia tỷ lệ. Đối với các điểm đánh dấu ký hiệu, mặc định là 1; sau khi điều chỉnh theo 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 nhiều đường, biểu tượng này mặc định có trọng số nét của đa giác; sau khi điều chỉnh theo tỷ lệ, biểu tượng phải nằm bên trong một hình vuông có kích thước 22 pixel nằm ở chính giữa 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ả màu CSS3 đều được hỗ trợ, ngoại trừ màu có tên mở rộng. Đối với các điểm đánh dấu ký hiệu, giá trị này sẽ được đặt mặc định là 'màu đen#39;. Đối với các ký hiệu trên một hình nhiều đường, thuộc tính này sẽ mặc định là màu nét vẽ của hình nhiều đường.
strokeOpacity optional
Loại: number optional
Độ mờ nét của biểu tượng. Đối với các điểm đánh dấu ký hiệu, giá trị mặc định là 1. Đối với các ký hiệu trên một hình nhiều đường, thuộc tính này được mặc định theo độ mờ nét vẽ của hình nhiều đường.
strokeWeight optional
Loại: number optional
Mặc định: Symbol.scale của biểu tượng.
Độ đậm của biểu tượng.

Hằng số SymbolPath

Hằng số google.maps.SymbolPath

Đường dẫn biểu tượng được tích hợp sẵn.

BACKWARD_CLOSED_ARROW Mũi tên chỉ hướng ngược lại.
BACKWARD_OPEN_ARROW Mũi tên mở trỏ về phía sau.
CIRCLE Vòng tròn.
FORWARD_CLOSED_ARROW Mũi tên chỉ hướng về phía trước.
FORWARD_OPEN_ARROW Mũi tên mở trỏ 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 Bút đánh dấu hoặc tuỳ chọn MarkerOptions.animation để phát ảnh động.

BOUNCE Điểm đánh dấu bị gửi trả lại cho đến khi ảnh động ngừng lại bằng cách gọi Marker.setAnimation với null.
DROP Điểm đánh dấu thả từ đầu bản đồ đến vị trí cuối cùng của bản đồ. Ảnh động sẽ dừng khi điểm đánh dấu ngừng hoạt động 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.