Bút dạ

lớp cuối cùng công khai Marker mở rộng Đối tượng

Biểu tượng được đặt tại một điểm cụ thể trên bề mặt bản đồ. Biểu tượng điểm đánh dấu được vẽ hướng dựa vào màn hình của thiết bị thay vì bề mặt bản đồ; tức là biểu tượng điểm đánh dấu không nhất thiết sẽ thay đổi hướng do việc xoay, nghiêng hoặc thu phóng trên bản đồ.

Điểm đánh dấu có các thuộc tính sau:

Alpha
Đặt độ mờ của điểm đánh dấu. Giá trị mặc định là 1.0.
Mỏ neo
Điểm trên hình ảnh sẽ được đặt ở vị trí LatLng của điểm đánh dấu. Tỷ lệ này mặc định là 50% từ bên trái và ở cuối hình ảnh.
Vị trí
Giá trị LatLng cho vị trí của điểm đánh dấu trên bản đồ. Bạn có thể thay đổi giá trị này bất cứ lúc nào nếu muốn di chuyển điểm đánh dấu.
Tiêu đề
Một chuỗi văn bản xuất hiện trong cửa sổ thông tin khi người dùng nhấn vào điểm đánh dấu. Bạn có thể thay đổi giá trị này bất cứ lúc nào.
Đoạn trích
Văn bản bổ sung hiển thị bên dưới tiêu đề. Bạn có thể thay đổi giá trị này bất cứ lúc nào.
Biểu tượng
Một bitmap hiển thị cho điểm đánh dấu. Nếu bạn không đặt biểu tượng này thì một biểu tượng mặc định sẽ hiển thị. Bạn có thể chỉ định màu thay thế cho biểu tượng mặc định bằng cách sử dụng defaultMarker(float).
Trạng thái kéo
Nếu bạn muốn cho phép người dùng kéo điểm đánh dấu, hãy thiết lập thuộc tính này thành true. Bạn có thể thay đổi giá trị này bất cứ lúc nào. Giá trị mặc định là false.
Chế độ hiển thị
Theo mặc định, điểm đánh dấu này sẽ xuất hiện. Để ẩn điểm đánh dấu, hãy đặt thuộc tính này thành false. Bạn có thể thay đổi giá trị này bất cứ lúc nào.
Mặt phẳng hoặc Biển quảng cáo
Nếu điểm đánh dấu nằm phẳng so với bản đồ, thì điểm đánh dấu đó sẽ vẫn nằm cố định trên bản đồ khi máy ảnh xoay và nghiêng, nhưng sẽ vẫn giữ nguyên kích thước khi máy ảnh thu phóng, không giống như GroundOverlay. Nếu điểm đánh dấu là biển quảng cáo, thì điểm này sẽ luôn được vẽ hướng về phía máy ảnh, đồng thời sẽ xoay và nghiêng cùng với máy ảnh. Mặc định là biển quảng cáo (false)
Chế độ xoay
Xoay điểm đánh dấu theo độ theo chiều kim đồng hồ quanh điểm neo của điểm neo. Trục xoay vuông góc với điểm đánh dấu. Mức xoay 0 tương ứng với vị trí mặc định của điểm đánh dấu. Khi điểm đánh dấu nằm phẳng trên bản đồ, vị trí mặc định sẽ được căn chỉnh theo hướng Bắc và xoay để điểm đánh dấu luôn giữ nguyên vị trí bằng phẳng trên bản đồ. Khi điểm đánh dấu là một biển quảng cáo, vị trí mặc định sẽ là hướng lên trên và xoay sao cho điểm đánh dấu luôn hướng về phía máy ảnh. Giá trị mặc định là "0".
zIndex
Thứ tự vẽ của điểm đánh dấu. Các điểm đánh dấu được vẽ theo thứ tự zIndex, trong đó điểm đánh dấu zIndex cao nhất được vẽ ở trên cùng. Bằng cách đặt thuộc tính zIndex cho mỗi điểm đánh dấu, bạn có thể kiểm soát mục tiêu nhấn nào mà người dùng của bạn có nhiều khả năng nhấn nhất. Giá trị mặc định là "0".
Gắn thẻ
Một Object được liên kết với điểm đánh dấu. Ví dụ: Object có thể chứa dữ liệu về nội dung mà điểm đánh dấu đại diện. Việc này sẽ dễ dàng hơn so với việc lưu trữ một Map<Marker, Object> riêng. Một ví dụ khác, bạn có thể liên kết một mã nhận dạng String tương ứng với mã nhận dạng trong tập dữ liệu. SDK Google Maps dành cho Android không đọc hay ghi thuộc tính này.

Các phương thức trong lớp này phải được gọi trên luồng giao diện người dùng Android. Nếu không, IllegalStateException sẽ được gửi trong thời gian chạy.

Ví dụ:

GoogleMap map = ... // get a map.
 // Add a marker at San Francisco.
 Marker marker = map.addMarker(new MarkerOptions()
     .position(new LatLng(37.7750, 122.4183))
     .title("San Francisco")
     .snippet("Population: 776733"));
 

Hướng dẫn cho nhà phát triển

Để biết thêm thông tin, hãy đọc hướng dẫn cho nhà phát triển về Mã đánh dấu.

Tóm tắt lớp lồng ghép

@giao diện Marker.CollisionBehavior Cho biết cách xử lý điểm đánh dấu khi bị va chạm với các điểm đánh dấu khác hoặc nhãn bản đồ cơ sở. 

Tóm tắt phương thức công khai

boolean
bằng(Đối tượng khác)
Kiểm tra xem Marker này có bằng với một giá trị khác hay không.
float
Hàm getAlpha()
Lấy giá trị alpha của điểm đánh dấu.
Chuỗi
getId()
Lấy mã nhận dạng của điểm đánh dấu này.
LatLng
getPosition()
Trả về vị trí của điểm đánh dấu.
float
Hàm getRotation()
Nhận chế độ xoay điểm đánh dấu.
Chuỗi
getSnippet()
Lấy đoạn mã của điểm đánh dấu.
Đối tượng
Hàm getTag()
Lấy thẻ cho điểm đánh dấu.
Chuỗi
getTitle()
Lấy tiêu đề của điểm đánh dấu.
float
getZIndex()
Trả về zIndex của điểm đánh dấu.
int
void
Hàm hideInfoWindow()
Ẩn cửa sổ thông tin nếu cửa sổ đó được hiển thị từ điểm đánh dấu này.
boolean
Hàm isDraggable()
Xem khả năng kéo của điểm đánh dấu.
boolean
Hàm isFlat()
Lấy chế độ cài đặt phẳng của Điểm đánh dấu.
boolean
isInfoWindowShown()
Trả về việc cửa sổ thông tin có đang hiển thị phía trên điểm đánh dấu này hay không.
boolean
isVisible()
Nhận chế độ hiển thị của điểm đánh dấu này.
void
xoá()
Xóa điểm đánh dấu này khỏi bản đồ.
void
setAlpha(số alpha nổi)
Đặt alpha (độ mờ) của điểm đánh dấu.
void
setAnchor(nổi neoU, neoV nổi)
Đặt điểm neo cho điểm đánh dấu.
void
setDraggable(boolean kéo được)
Đặt khả năng kéo của điểm đánh dấu.
void
setFlat(boolean phẳng)
Thiết lập xem điểm đánh dấu này phải nằm phẳng so với bản đồ true hay một biển quảng cáo hướng về phía máy ảnh false.
void
setIcon(BitmapDescriptor iconDescriptor)
Đặt biểu tượng cho điểm đánh dấu.
void
setInfoWindowAnchor(nổi neoU, neoV nổi)
Chỉ định điểm trong hình ảnh điểm đánh dấu để neo cửa sổ thông tin khi cửa sổ đó được hiển thị.
void
setPosition(LatLng latlng)
Đặt vị trí của điểm đánh dấu.
void
setRotation(xoay nổi)
Đặt xoay điểm đánh dấu theo độ theo chiều kim đồng hồ đối với điểm neo của điểm neo.
void
setSnippet(Đoạn mã chuỗi)
Đặt đoạn mã của điểm đánh dấu.
void
setTag(Thẻ đối tượng)
Đặt thẻ cho điểm đánh dấu.
void
setTitle(Tiêu đề chuỗi)
Đặt tiêu đề của điểm đánh dấu.
void
setVisible(boolean hiển thị)
Đặt chế độ hiển thị của điểm đánh dấu này.
void
setZIndex(số thực dấu phẩy động zIndex)
Đặt zIndex của điểm đánh dấu.
void
showInfoWindow()
Hiển thị cửa sổ thông tin của điểm đánh dấu này trên bản đồ, nếu điểm đánh dấu này là isVisible().

Tóm tắt phương thức kế thừa

Phương thức công khai

boolean công khai bằng (Đối tượng khác)

Kiểm tra xem Marker này có bằng với một giá trị khác hay không.

Các tham số
Chi phí khác một Object.
Trả bóng
  • true nếu cả hai đối tượng là cùng một đối tượng, nghĩa là đây == khác.

số thực công khai getAlpha ()

Lấy giá trị alpha của điểm đánh dấu.

Trả bóng
  • giá trị alpha của điểm đánh dấu trong khoảng [0, 1].

công khai Chuỗi getId ()

Lấy mã nhận dạng của điểm đánh dấu này. Mã nhận dạng sẽ là duy nhất trong số tất cả các Điểm đánh dấu trên bản đồ.

Trả bóng
  • mã nhận dạng của điểm đánh dấu này.

công khai LatLng getPosition ()

Trả về vị trí của điểm đánh dấu.

Trả bóng
  • Đối tượng LatLng chỉ định vị trí hiện tại của điểm đánh dấu.

public float getRotation ()

Nhận chế độ xoay điểm đánh dấu.

Trả bóng
  • xoay điểm đánh dấu theo độ theo chiều kim đồng hồ so với vị trí mặc định.

công khai Chuỗi getSnippet ()

Lấy đoạn mã của điểm đánh dấu.

Trả bóng
  • Một chuỗi có chứa đoạn mã của điểm đánh dấu.

công khai Đối tượng getTag ()

Lấy thẻ cho điểm đánh dấu.

Trả bóng
  • thẻ nếu thẻ được đặt bằng setTag; null nếu chưa có thẻ nào được đặt.

công khai Chuỗi getTitle ()

Lấy tiêu đề của điểm đánh dấu.

Trả bóng
  • Một chuỗi ký tự chứa tiêu đề của điểm đánh dấu.

public float getZIndex ()

Trả về zIndex của điểm đánh dấu.

Trả bóng
  • zIndex của điểm đánh dấu này.

public int hashCode ()

công khai void hideInfoWindow ()

Ẩn cửa sổ thông tin nếu cửa sổ đó được hiển thị từ điểm đánh dấu này.

Phương thức này không có tác dụng nếu điểm đánh dấu này không hiển thị.

công khai boolean isDraggable ()

Xem khả năng kéo của điểm đánh dấu. Khi một điểm đánh dấu có thể kéo, người dùng có thể di chuyển điểm đánh dấu đó bằng cách nhấn và giữ điểm đánh dấu đó.

Trả bóng
  • Là giá trị true nếu điểm đánh dấu là có thể kéo; nếu không sẽ trả về false.

công khai boolean isFlat ()

Lấy chế độ cài đặt phẳng của Điểm đánh dấu.

Trả bóng
  • true nếu điểm đánh dấu nằm phẳng so với bản đồ; false nếu điểm đánh dấu phải hướng về phía máy ảnh.

giá trị boolean công khai isInfoWindowShown ()

Trả về việc cửa sổ thông tin có đang hiển thị phía trên điểm đánh dấu này hay không. Điều này không xét đến việc cửa sổ thông tin có thực sự hiển thị trên màn hình hay không.

boolean công khai isVisible ()

Nhận chế độ hiển thị của điểm đánh dấu này. Xin lưu ý rằng điều này không cho biết liệu điểm đánh dấu có nằm trong khung nhìn của màn hình hay không. Thuộc tính này cho biết liệu điểm đánh dấu có được vẽ hay không nếu điểm đánh dấu nằm trong khung nhìn của màn hình.

Trả bóng
  • mức độ hiển thị của điểm đánh dấu này.

công khai khoảng trống xoá ()

Xóa điểm đánh dấu này khỏi bản đồ. Sau khi một điểm đánh dấu bị xoá, hành vi của tất cả các phương thức của điểm đánh dấu đó sẽ không xác định được.

công khai khoảng trống setAlpha (nổi alpha)

Đặt alpha (độ mờ) của điểm đánh dấu. Đây là giá trị từ 0 đến 1, trong đó 0 có nghĩa là điểm đánh dấu hoàn toàn trong suốt và 1 có nghĩa là điểm đánh dấu hoàn toàn không trong suốt.

Các tham số
alpha

công khai khoảng trống setAnchor (float neoU, float anchorV)

Đặt điểm neo cho điểm đánh dấu.

Neo chỉ định một điểm trong hình ảnh biểu tượng được neo vào vị trí của điểm đánh dấu trên bề mặt Trái Đất.

Điểm neo được chỉ định trong không gian liên tục [0.0, 1.0] x [0.0, 1.0], trong đó (0, 0) là góc trên cùng bên trái của hình ảnh và (1, 1) là góc dưới cùng bên phải. Điểm neo trong hình ảnh W x H là điểm lưới rời rạc gần nhất trong lưới (W + 1) x (H + 1), thu được bằng cách chia tỷ lệ sau đó làm tròn. Ví dụ: trong hình ảnh 4 x 2, điểm neo (0,7, 0,6) phân giải thành điểm lưới ở (3, 1).

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*
 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----X-----+   (X, Y) = (3, 1)
 |     |     |     |     |
 |     |     |     |     |
 *-----+-----+-----+-----*
 

Các tham số
anchorU toạ độ u của neo, như là tỷ lệ chiều rộng hình ảnh (trong phạm vi [0, 1]).
anchorV toạ độ v của neo, theo tỷ lệ chiều cao của hình ảnh (trong phạm vi [0, 1]).

công khai khoảng trống setDraggable (boolean draggable)

Đặt khả năng kéo của điểm đánh dấu. Khi một điểm đánh dấu có thể kéo, người dùng có thể di chuyển điểm đánh dấu đó bằng cách nhấn và giữ điểm đánh dấu đó.

Các tham số
kéo được

public void setFlat (boolean phẳng)

Thiết lập xem điểm đánh dấu này phải nằm phẳng so với bản đồ true hay một biển quảng cáo hướng về phía máy ảnh false.

Các tham số
không

công khai khoảng trống setIcon (BitmapDescriptor iconDescriptor)

Đặt biểu tượng cho điểm đánh dấu.

Các tham số
iconDescriptor nếu giá trị rỗng, điểm đánh dấu mặc định sẽ được sử dụng.

công khai khoảng trống setInfoWindowAnchor (float neoU, float anchorV)

Chỉ định điểm trong hình ảnh điểm đánh dấu để neo cửa sổ thông tin khi cửa sổ đó được hiển thị. Công thức này được xác định trong cùng một hệ toạ độ với điểm neo. Hãy xem setAnchor(float, float) để biết thêm chi tiết. Giá trị mặc định là phần giữa trên cùng của hình ảnh.

Các tham số
anchorU toạ độ u của neo cửa sổ thông tin, như là tỷ lệ chiều rộng của hình ảnh (trong phạm vi [0, 1]).
anchorV toạ độ v của neo cửa sổ thông tin, theo tỷ lệ chiều cao của hình ảnh (trong phạm vi [0, 1]).

public void setPosition (LatLng latlng)

Đặt vị trí của điểm đánh dấu.

Các tham số
CANNOT TRANSLATE

public void setRotation (float rotation)

Đặt xoay điểm đánh dấu theo độ theo chiều kim đồng hồ đối với điểm neo của điểm neo. Trục xoay vuông góc với điểm đánh dấu. Mức xoay 0 tương ứng với vị trí mặc định của điểm đánh dấu.

Các tham số
xoay

công khai khoảng trống setSnippet (Đoạn mã chuỗi)

Đặt đoạn mã của điểm đánh dấu.

Các tham số
đoạn trích nếu giá trị rỗng, đoạn mã sẽ bị xoá.

công khai khoảng trống setTag (Thẻ đối tượng)

Đặt thẻ cho điểm đánh dấu.

Bạn có thể sử dụng thuộc tính này để liên kết một Object tuỳ ý với điểm đánh dấu này. Ví dụ: Object có thể chứa dữ liệu về nội dung mà điểm đánh dấu đại diện. Việc này sẽ dễ dàng hơn so với việc lưu trữ một Map<Marker, Object> riêng. Một ví dụ khác, bạn có thể liên kết một mã nhận dạng String tương ứng với mã trong một tập dữ liệu. SDK Google Maps dành cho Android không đọc hay ghi thuộc tính này. Bạn có trách nhiệm gọi setTag(null) để xoá thẻ khi không cần nữa, nhằm ngăn ngừa rò rỉ bộ nhớ trong ứng dụng của bạn.

Các tham số
tag nếu giá trị rỗng, thẻ sẽ bị xoá.

public void setTitle (String title)

Đặt tiêu đề của điểm đánh dấu.

Các tham số
tiêu đề nếu giá trị rỗng, tiêu đề sẽ bị xóa.

public void setVisible (boolean visible)

Đặt chế độ hiển thị của điểm đánh dấu này. Nếu bạn đặt thành false và một cửa sổ thông tin đang hiển thị cho điểm đánh dấu này, thì cửa sổ thông tin sẽ bị ẩn.

Các tham số
hiển thị

công khai khoảng trống setZIndex (float zIndex)

Đặt zIndex của điểm đánh dấu.

Các tham số
zIndex

public void showInfoWindow ()

Hiển thị cửa sổ thông tin của điểm đánh dấu này trên bản đồ, nếu điểm đánh dấu này là isVisible().

Gửi
IllegalArgumentException nếu marker không có trên bản đồ này