Kiểu bản đồ mới sắp xuất hiện trên Nền tảng Google Maps. Bản cập nhật này để tạo kiểu bản đồ bao gồm một bảng màu mặc định mới và các cải tiến về trải nghiệm bản đồ cũng như khả năng hữu dụng. Tất cả kiểu bản đồ sẽ được cập nhật tự động vào tháng 3 năm 2025. Để biết thêm thông tin về phạm vi cung cấp và cách chọn tham gia sớm hơn, hãy xem bài viết Kiểu bản đồ mới cho Nền tảng Google Maps.

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

Tùy chọn điểm đánh dấu

lớp cuối cùng công khai MarkerOptions mở rộng Đối tượng
implements Theo gói

Xác định MarkerOptions cho một điểm đánh dấu.

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

Để biết thêm thông tin, hãy đọc bài viết về nhà phát triển Điểm đánh dấu của chúng tôi.

Tóm tắt hằng số kế thừa

Từ giao diện android.os.Parcelable

int	CONTENTS_FILE_DESCRIPTOR
int	PARCELABLE_WRITE_RETURN_VALUE

Tóm tắt hàm khởi tạo công khai

MarkerOptions()

Tạo một bộ tuỳ chọn điểm đánh dấu mới.

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

MarkerOptions	alpha(alpha nổi) Đặt độ đậm nhạt (độ mờ) của điểm đánh dấu.
MarkerOptions	neo(dấu phẩy động u; dấu phẩy động v) Chỉ định điểm neo tại một điểm cụ thể trong hình ảnh điểm đánh dấu.
MarkerOptions	collisionBehavior(int crashBehavior) Đặt trạng thái xung đột cho điểm đánh dấu.
MarkerOptions	có thể kéo(boolean có thể kéo được) Đặt khả năng kéo cho điểm đánh dấu.
MarkerOptions	flat(boolean flat) Đặt điểm đánh dấu này phải nằm trên bản đồ `true` hoặc biển quảng cáo đối diện với máy ảnh `false`.
số thực dấu phẩy động	getAlpha() Lấy tập hợp alpha cho đối tượng `MarkerOptions` này.
số thực dấu phẩy động	getAnchorU() Khoảng cách theo chiều ngang, được chuẩn hoá thành [0, 1], của neo từ cạnh trái.
số thực dấu phẩy động	getAnchorV() Khoảng cách dọc, được chuẩn hoá thành [0, 1] của neo từ cạnh trên.
int	getCollisionBehavior()
BitmapDescriptor	getIcon() Lấy tập hợp chỉ số mô tả biểu tượng tuỳ chỉnh cho đối tượng `MarkerOptions` này.
số thực dấu phẩy động	getInfoWindowAnchorU() Khoảng cách theo chiều ngang, được chuẩn hoá thành [0, 1] của cửa sổ thông tin cố định từ cạnh trái.
số thực dấu phẩy động	getInfoWindowAnchorV() Khoảng cách dọc, được chuẩn hoá thành [0, 1] của điểm neo cửa sổ thông tin từ cạnh trên cùng.
LatLng	getPosition() Trả về vị trí được đặt cho đối tượng `MarkerOptions` này.
số thực dấu phẩy động	getRotation() Lấy chế độ xoay đã thiết lập cho đối tượng `MarkerOptions` này.
Chuỗi	getSnippet() Lấy đoạn mã được đặt cho đối tượng `MarkerOptions` này.
Chuỗi	getTitle() Lấy tiêu đề được đặt cho đối tượng `MarkerOptions` này.
số thực dấu phẩy động	getZIndex() Lấy tập hợp zIndex cho đối tượng `MarkerOptions` này.
MarkerOptions	biểu tượng(BitmapDescriptor iconDescriptor) Đặt biểu tượng cho điểm đánh dấu.
MarkerOptions	infoWindowAnchor(float u, float v) Chỉ định điểm neo của cửa sổ thông tin trên hình ảnh điểm đánh dấu.
boolean	isDraggable() Xem chế độ cài đặt về khả năng kéo cho đối tượng `MarkerOptions` này.
boolean	isFlat() Lấy chế độ cài đặt cố định cho đối tượng `MarkerOptions` này.
boolean	isVisible() Lấy chế độ cài đặt chế độ hiển thị cho đối tượng `MarkerOptions` này.
MarkerOptions	location(LatLng latlng) Đặt vị trí cho điểm đánh dấu.
MarkerOptions	xoay(xoay số thực) Đặt xoay điểm đánh dấu theo độ theo chiều kim đồng hồ quanh điểm neo của điểm đánh dấu.
MarkerOptions	snippet(Đoạn mã chuỗi) Đặt đoạn mã cho điểm đánh dấu.
MarkerOptions	title(Tiêu đề chuỗi) Đặt tiêu đề cho điểm đánh dấu.
MarkerOptions	visible(boolean visible) Đặt chế độ hiển thị cho điểm đánh dấu.
MarkerOptions	zIndex(nổi zIndex) Đặt zIndex cho điểm đánh dấu.

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

Của lớp học java.lang.Object

boolean	bằng(Đối tượng arg0)
cuối cùng Lớp<?>	getClass()
int	hashCode()
cuối cùng trống	notify()
cuối cùng trống	notifyAll()
Chuỗi	toString()
cuối cùng trống	chờ(long arg0, int arg1)
cuối cùng trống	chờ(long arg0)
cuối cùng trống	wait()

Từ giao diện android.os.Parcelable

trừu tượng đánh chặn	describeContents()
trừu tượng trống	writeToParcel(Parcel arg0, int arg1)

Công ty xây dựng công cộng

công khai MarkerOptions ()

Tạo một bộ tuỳ chọn điểm đánh dấu mới.

Phương thức công khai

công khai MarkerOptions alpha (alpha nổi)

Đặt độ đậm nhạt (độ mờ) của điểm đánh dấu. Đây là một 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 mờ đục.

Tham số

alpha

Giá trị trả về

đối tượng mà phương thức được gọi, với tập hợp alpha mới.

công khai MarkerOptions quảng cáo cố định (số thực dấu phẩy động u, số thực v)

Chỉ định điểm neo tại một điểm cụ thể trong hình ảnh điểm đánh dấu.

Điể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 xác đị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 riêng biệt gần nhất trong khoảng (W + 1) x Lưới (H + 1), có đượ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 tại (3, 1).

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

Tham số

u	Toạ độ u của neo, là tỷ lệ chiều rộng hình ảnh (trong phạm vi [0, 1])
so với	toạ độ v của điểm neo, là tỷ lệ chiều cao hình ảnh (trong phạm vi [0, 1])

Giá trị trả về

đối tượng mà phương thức được gọi với tập hợp neo mới.

công khai MarkerOptions collisionBehavior (int crashBehavior)

Đặt trạng thái xung đột cho điểm đánh dấu. Đây là giá trị của Marker.CollisionBehavior. Chiến dịch này có thể chỉ có thể đặt một lần.

Tham số

collisionBehavior

Giá trị trả về

đối tượng mà phương thức được gọi, với trạng thái xung đột được thiết lập.

công khai MarkerOptions có thể kéo (boolean có thể kéo)

Đặt khả năng kéo cho điểm đánh dấu.

Tham số

kéo được

Giá trị trả về

đối tượng mà phương thức được gọi, với trạng thái có thể kéo mới được thiết lập.

công khai MarkerOptions bằng phẳng (boolean phẳng)

Đặt điểm đánh dấu này phải nằm trên bản đồ true hoặc biển quảng cáo đối diện với máy ảnh false. Nếu điểm đánh dấu nằm trên bản đồ, điểm đánh dấu sẽ vẫn được đặt cố định trên bản đồ vì máy ảnh quay và nghiêng nhưng 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à một biển quảng cáo, thì nó sẽ luôn được vẽ hướng về phía máy ảnh sẽ xoay và nghiêng cùng với máy ảnh. Giá trị mặc định là false.

Tham số

không

Giá trị trả về

đối tượng mà phương thức được gọi, với tập hợp trạng thái phẳng mới.

công khai độ chính xác đơn getAlpha ()

Lấy tập hợp alpha cho đối tượng MarkerOptions này.

Giá trị trả về

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

công khai độ chính xác đơn getAnchorU ()

Khoảng cách theo chiều ngang, được chuẩn hoá thành [0, 1], của neo từ cạnh trái.

Giá trị trả về

giá trị u của điểm neo.

công khai độ chính xác đơn getAnchorV ()

Khoảng cách dọc, được chuẩn hoá thành [0, 1] của neo từ cạnh trên.

Giá trị trả về

giá trị v của điểm neo.

công khai đánh chặn getCollisionBehavior ()

công khai BitmapDescriptor getIcon ()

Lấy tập hợp chỉ số mô tả biểu tượng tuỳ chỉnh cho đối tượng MarkerOptions này.

Giá trị trả về

BitmapDescriptor đại diện cho biểu tượng tuỳ chỉnh hoặc null nếu không có tuỳ chỉnh biểu tượng đã được đặt.

công khai độ chính xác đơn getInfoWindowAnchorU ()

Khoảng cách theo chiều ngang, được chuẩn hoá thành [0, 1] của cửa sổ thông tin cố định từ cạnh trái.

Giá trị trả về

giá trị u của điểm neo cửa sổ thông tin.

công khai độ chính xác đơn getInfoWindowAnchorV ()

Khoảng cách dọc, được chuẩn hoá thành [0, 1] của điểm neo cửa sổ thông tin từ cạnh trên cùng.

Giá trị trả về

giá trị v của điểm neo cửa sổ thông tin.

công khai LatLng getPosition ()

Trả về vị trí được đặt cho đối tượng MarkerOptions này.

Giá trị trả về

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

công khai độ chính xác đơn getRotation ()

Lấy chế độ xoay đã thiết lập cho đối tượng MarkerOptions này.

Giá trị trả về

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 văn bản getSnippet ()

Lấy đoạn mã được đặt cho đối tượng MarkerOptions này.

Giá trị trả về

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

công khai Chuỗi văn bản getTitle ()

Lấy tiêu đề được đặt cho đối tượng MarkerOptions này.

Giá trị trả về

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

công khai độ chính xác đơn getZIndex ()

Lấy tập hợp zIndex cho đối tượng MarkerOptions này.

Giá trị trả về

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

công khai MarkerOptions biểu tượng (BitmapDescriptor iconDescriptor)

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

Tham số

iconDescriptor	nếu là `null`, điểm đánh dấu mặc định sẽ được sử dụng.

Giá trị trả về

đối tượng mà phương thức được gọi, với bộ mô tả biểu tượng mới.

công khai MarkerOptions infoWindowAnchor (số thực dấu phẩy động u, số thực v)

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

Tham số

u	Toạ độ u của điểm neo cửa sổ thông tin, là tỷ lệ chiều rộng của hình ảnh (trong phạm vi [0, 1])
so với	toạ độ v của điểm neo cửa sổ thông tin, là tỷ lệ chiều cao hình ảnh (trong phạm vi [0, 1])

Giá trị trả về

đối tượng mà phương thức được gọi, với chuỗi neo cửa sổ thông tin mới.

công khai boolean isDraggable ()

Xem chế độ cài đặt về khả năng kéo cho đối tượng MarkerOptions này.

Giá trị trả về

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

công khai boolean isFlat ()

Lấy chế độ cài đặt cố định cho đối tượng MarkerOptions này.

Giá trị trả về

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

công khai boolean isVisible ()

Lấy chế độ cài đặt chế độ hiển thị cho đối tượng MarkerOptions này.

Giá trị trả về

true nếu điểm đánh dấu hiển thị; nếu không, sẽ trả về false.

công khai MarkerOptions vị trí (LatLng vĩ độ)

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

Tham số

vĩ độ

Giá trị trả về

đối tượng mà phương thức được gọi, với vị trí mới được thiết lập.

công khai MarkerOptions xoay (xoay số thực)

Đặt xoay điểm đánh dấu theo độ theo chiều kim đồng hồ quanh điểm neo của điểm đánh dấu. 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 bằng phẳng trên bản đồ, vị trí mặc định là căn Bắc và việc xoay sao cho điểm đánh dấu luôn giữ nguyên trên bản đồ. Khi điểm đánh dấu là biển quảng cáo, vị trí mặc định là hướng lên và hướng 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".

Tham số

xoay

Giá trị trả về

đối tượng mà phương thức được gọi, với chế độ xoay mới được thiết lập.

công khai MarkerOptions đoạn mã (Đoạn mã chuỗi)

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

Tham số

đoạn trích

Giá trị trả về

đối tượng mà phương thức được gọi, với đoạn mã mới.

công khai MarkerOptions tiêu đề (Tiêu đề chuỗi)

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

Tham số

tiêu đề

Giá trị trả về

đối tượng mà phương thức được gọi, với tiêu đề mới được đặt.

công khai MarkerOptions hiển thị (boolean hiển thị)

Đặt chế độ hiển thị cho điểm đánh dấu.

Tham số

hiển thị

Giá trị trả về

đối tượng mà phương thức được gọi, với trạng thái hiển thị mới được thiết lập.

công khai MarkerOptions zIndex (độ chính xác đơn zIndex)

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

Tham số

zIndex

Giá trị trả về

đối tượng mà phương thức được gọi, với tập hợp zIndex mới.