Trang này được dịch bởi Cloud Translation API.

Bút dạ

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

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

Đ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. Giá trị mặc định là 50% từ bên trái hình ảnh và dưới cùng của hình ảnh.
Vị trí: Giá trị LatLng của vị trí điểm đánh dấu trên bản đồ. Bạn có thể thay đổi giá trị này bất kỳ 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 hiển thị 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 mã: Văn bản bổ sung xuất hiện bên dưới tiêu đề. Bạn có thể thay đổi giá trị này bất kỳ lúc nào.
Biểu tượng: Một bitmap do hệ thống hiển thị cho điểm đánh dấu. Nếu bạn không đặt chính sách này, thì hệ thống sẽ hiển thị một biểu tượng mặc định. 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 đặt 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. Mặc định là false.
Chế độ hiển thị: Theo mặc định, điểm đánh dấu sẽ hiển thị. Để điểm đánh dấu không hiển thị, hãy đặt thuộc tính này thành false. Bạn có thể thay đổi giá trị này bất kỳ lúc nào.
Bằng phẳng hoặc biển quảng cáo: Nếu điểm đánh dấu phẳng so với bản đồ, điểm đánh dấu này sẽ vẫn giữ nguyên trên bản đồ khi máy ảnh xoay và nghiêng nhưng sẽ vẫn giữ nguyên kích thước như khi máy ảnh thu phóng, không giống như GroundOverlay. Nếu điểm đánh dấu là một biển quảng cáo, thì biển quảng cáo đó sẽ luôn được vẽ về phía máy ảnh và sẽ xoay và nghiêng bằng máy ảnh. Giá trị mặc định là biển quảng cáo (false)
Xoay: Xoay điểm đánh dấu theo độ kim đồng hồ về điểm neo của điểm đánh dấu. Trục xoay có vuông góc với điểm đánh dấu. Độ 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 phẳng trên bản đồ, vị trí mặc định sẽ được căn chỉnh theo hướng Bắc và độ xoay sao cho điểm đánh dấu luôn 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ẽ hướng lê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".
Chỉ mục zIndex: Thứ tự vẽ cho đ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 đạt được nhất. Giá trị mặc định là "0".
Thẻ: 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 đánh dấu đại diện. Thao tác này dễ dàng hơn việc lưu trữ một Map<Marker, Object> riêng biệt. Một ví dụ khác, bạn có thể liên kết mã nhận dạng String tương ứng với mã nhận dạng từ 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.

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 vào 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 dành cho nhà phát triển Markers.

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

@giao diện Marker.CollisionBehavior Cho biết cách xử lý điểm đánh dấu khi có xung đột 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 pháp công khai

boolean	equals (Đối tượng khác) Kiểm tra xem `Marker` này có tương đương với một kiểm thử khác hay không.
số thực dấu phẩy động	getAlpha() Lấy alpha của điểm đánh dấu.
Chuỗi	getId() Lấy mã nhận dạng điểm đánh dấu này.
LatLng	getPosition() Trả về vị trí của điểm đánh dấu.
số thực dấu phẩy động	getRotation() Nhận chế độ xoay của điểm đánh dấu.
Chuỗi	getsnippet() Lấy đoạn mã của điểm đánh dấu.
Đối tượng	getTag() Lấy thẻ cho điểm đánh dấu.
Chuỗi	getTitle() Lấy tiêu đề của điểm đánh dấu.
số thực dấu phẩy động	getZIndex() Trả về zIndex của điểm đánh dấu.
int	hashCode()
void	HideInfoWindow() Ẩn cửa sổ thông tin nếu cửa sổ hiển thị từ điểm đánh dấu này.
boolean	isDraggable() Nhận khả năng kéo của điểm đánh dấu.
boolean	is flat() Xem chế độ cài đặt đánh dấu phẳng.
boolean	isInfoWindowWindow() Trả về kết quả là cửa sổ thông tin hiện có xuất hiện ở phía trên điểm đánh dấu này hay không.
boolean	isHiển thị() Nhận chế độ hiển thị cho điểm đánh dấu này.
void	remove() Xóa điểm đánh dấu này khỏi bản đồ.
void	setAlpha(phần tử alpha nổi) Đặt độ đậm nhạt (alpha) của điểm đánh dấu.
void	setAnchor(nổi quảng cáo cố định, float neo V) Đặt điểm neo cho điểm đánh dấu.
void	setDraggable (boolean có thể kéo) Đặt khả năng kéo của điểm đánh dấu.
void	set phẳng(boolean phẳng) Đặt xem điểm đánh dấu này phải bằng phẳng trên bản đồ `true` hay là một biển quảng cáo hướng tới máy ảnh `false`.
void	setIcon(BitmapDescriptor iconDescriptor) Đặt biểu tượng cho điểm đánh dấu.
void	setInfoWindowAnchor(làm nổi neoUU, float neoVV) Chỉ định điểm trong hình ảnh điểm đánh dấu để neo cửa sổ thông tin khi hình ảnh đó hiển thị.
void	setPosition(LatLng latlng) Đặt vị trí của điểm đánh dấu.
void	setRotation (xoay màn hình nổi) Đặt độ xoay của điểm đánh dấu theo độ kim đồng hồ về điểm neo của điểm đánh dấu.
void	setsnippet(Đoạn mã chuỗi) Đặt đoạn 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(hiển thị boolean) Đặt chế độ hiển thị của điểm đánh dấu này.
void	setZIndex(nổi 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 pháp kế thừa

Từ lớp java.lang.Object

boolean	equals(Đối số arg0)
lớp cuối cùng Class<?>	getClass()
int	hashCode()
khoảng trống cuối cùng	notifications()
khoảng trống cuối cùng	notifyAll()
Chuỗi	toString()
khoảng trống cuối cùng	wait (long arg0, int arg1)
khoảng trống cuối cùng	wait (args dài)
khoảng trống cuối cùng	wait()

Phương thức công khai

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

Kiểm tra xem Marker này có tương đương với một kiểm thử khác hay không.

Các tham số

Chi phí khác	`Object`.

Trả về

true nếu cả hai đối tượng là cùng một đối tượng, nghĩa là == khác.

dấu phẩy động công khai getAlpha ()

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

Trả về

alpha của điểm đánh dấu trong phạm vi [0, 1].

public Chuỗi getId ()

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

Trả về

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ả về

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

công khai float getRotation ()

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

Trả về

xoay điểm đánh dấu theo độ theo chiều kim đồng hồ từ vị trí mặc định.

public Chuỗi getsnippet ()

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

Trả về

Một chuỗi 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ả về

thẻ này nếu thẻ được đặt bằng setTag; null nếu bạn chưa đặt thẻ nào.

công khai Chuỗi getTitle ()

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

Trả về

Một chuỗi chứa tiêu đề của điểm đánh dấu.

float công khai getZIndex ()

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

Trả về

điểm đánh dấu zIndex này.

public int hashCode ()

public void HideInfoWindow ()

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

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

boolean công khai isDraggable ()

Nhận 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ả về

true nếu điểm đánh dấu có thể kéo được; nếu không, trả về false.

boolean công khai isFlat ()

Xem chế độ cài đặt đánh dấu phẳng.

Trả về

true nếu điểm đánh dấu phẳng so với bản đồ; false nếu điểm đánh dấu phải đối diện với máy ảnh.

boolean công khai isInfoWindowWindow ()

Trả về kết quả là cửa sổ thông tin hiện có xuất hiện ở phía trên điểm đánh dấu này hay không. Việc này không xem xét liệu cửa sổ thông tin có thực sự xuất hiện trên màn hình hay không.

boolean công khai isVisible ()

Nhận chế độ hiển thị cho điểm đánh dấu này. Xin lưu ý rằng thông tin này không cho biết điểm đánh dấu có nằm trong khung nhìn của màn hình hay không. Nó cho biết đ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ả về

khả năng hiển thị của điểm đánh dấu này.

công khai khoảng trống xóa ()

Xóa điểm đánh dấu này khỏi bản đồ. Sau khi đ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 đó chưa được xác định.

public void setAlpha (float alpha)

Đặt độ đậm nhạt (alpha) 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

public void setAnchor (float neoU, float neoV)

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

Mỏ neo chỉ định đ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 gần nhất trong lưới (W + 1) x (H + 1), lấy bằng cách điều chỉnh tỷ lệ làm tròn rồi 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 tại (3, 1).

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

Các tham số

liên kết	tọa độ u của neo, dưới dạng tỷ lệ của chiều rộng hình ảnh (trong phạm vi [0, 1]).
liên kết V	tọa độ v của neo, dưới dạng tỷ lệ của chiều cao hình ảnh (trong phạm vi [0, 1]).

public void 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)

Đặt xem điểm đánh dấu này phải bằng phẳng trên bản đồ true hay là một biển quảng cáo hướng tới máy ảnh false.

Các tham số

không

public void setIcon (BitmapDescriptor iconDescriptor)

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

Các tham số

biểu tượng	Nếu giá trị rỗng, thì điểm đánh dấu mặc định sẽ được sử dụng.

public void setInfoWindowAnchor (float neoU, float neoV)

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

Các tham số

liên kết	tọa độ u của neo cửa sổ thông tin, dưới dạng tỷ lệ giữa chiều rộng hình ảnh (trong phạm vi [0, 1]).
liên kết V	tọa độ của neo cửa sổ thông tin, dưới dạng tỷ lệ của chiều cao 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ố

chốt

công khai khoảng trống setRotation (xoay nổi)

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

Các tham số

xoay

public void setsnippet (Chuỗi đoạn mã)

Đặt đoạn mã đánh dấu.

Các tham số

đoạn mã	nếu giá trị rỗng thì đoạn mã sẽ bị xoá.

public void 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 tùy ý với điểm đánh dấu này. Ví dụ: Object có thể chứa dữ liệu về nội dung đánh dấu đại diện. Thao tác này dễ dàng hơn so với việc lưu trữ một Map<Marker, Object> riêng biệ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ã đó từ 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 nữa để ngăn rò rỉ bộ nhớ trong ứng dụng.

Các tham số

tag	Nếu giá trị là rỗng, thẻ này 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 thì tiêu đề sẽ bị xoá.

public void setVisible (boolean tối ưu hoá)

Đặ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 hiện đang hiển thị cho điểm đánh dấu này, thì cửa sổ thông tin này sẽ ẩn.

Các tham số

hiển thị

public void setZIndex (float zIndex)

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

Các tham số

Chỉ mục 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

Mục ngoại lệ không hợp lệ	nếu `marker` không có trên bản đồ này