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 công khai cuối cùng MarkerOptions mở rộng Đối tượng
triển khai Parcelable

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 hướng dẫn cho nhà phát triển về Mã đánh dấu.

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 về hàm khởi tạo công khai

MarkerOptions()

Tạo một tập hợp các tuỳ chọn điểm đánh dấu mới.

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

MarkerOptions	alpha(số alpha nổi) Đặt alpha (độ mờ) của điểm đánh dấu.
MarkerOptions	anchor(số thực dấu phẩy động u, số thực v) Chỉ định neo tại một điểm cụ thể trong hình ảnh đánh dấu.
MarkerOptions	collisionBehavior(int ronBehavior) Đặt trạng thái xung đột cho điểm đánh dấu.
MarkerOptions	draggable(Boolean có thể kéo được) Đặt khả năng kéo cho điểm đánh dấu.
MarkerOptions	flat(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`.
float	Hàm getAlpha() Lấy giá trị alpha đặt riêng cho đối tượng `MarkerOptions` này.
float	Hàm getAnchorU() Khoảng cách theo chiều ngang, được chuẩn hoá thành [0, 1], của neo tính từ cạnh bên trái.
float	Hàm getAnchorV() Khoảng cách dọc, được chuẩn hoá thành [0, 1], của neo tính từ cạnh trên cùng.
int	getCollisionBehavior()
BitmapDescriptor	getIcon() Lấy bộ mô tả biểu tượng tuỳ chỉnh được đặt cho đối tượng `MarkerOptions` này.
float	getInfoWindowAnchorU() Khoảng cách theo chiều ngang, được chuẩn hoá thành [0, 1], của neo cửa sổ thông tin từ cạnh bên trái.
float	getInfoWindowAnchorV() Khoảng cách dọc, được chuẩn hoá thành [0, 1], của neo cửa sổ thông tin tính từ cạnh trên cùng.
LatLng	getPosition() Trả về vị trí đã đặt cho đối tượng `MarkerOptions` này.
float	Hàm getRotation() Lấy chế độ xoay được đặt 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.
float	getZIndex() Lấy zIndex được đặt cho đối tượng `MarkerOptions` này.
MarkerOptions	icon(BitmapDescriptor iconDescriptor) Đặt biểu tượng cho điểm đánh dấu.
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.
boolean	Hàm isDraggable() Lấy chế độ cài đặt về khả năng kéo cho đối tượng `MarkerOptions` này.
boolean	Hàm isFlat() Lấy chế độ cài đặt phẳng 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	vị trí(LatLng) Đặt vị trí cho điểm đánh dấu.
MarkerOptions	xoay(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.
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 hiển thị) Đặt chế độ hiển thị cho điểm đánh dấu.
MarkerOptions	zIndex(chỉ mục số thực dấu phẩy động) Đặt zIndex cho điểm đánh dấu.

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

Trong lớp java.lang.Object

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

Từ giao diện android.os.Parcelable

số nguyên trừu tượng	describeContents()
trừu tượng khoả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 tập hợp các tuỳ chọn điểm đánh dấu mới.

Phương thức công khai

công khai MarkerOptions alpha (float 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

Trả bóng

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

công khai MarkerOptions anchor (float u, float v)

Chỉ định neo tại một điểm cụ thể trong hình ảnh đá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ố

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

Trả bóng

đối tượng mà phương thức được gọi, với bộ neo mới.

công khai MarkerOptions collisionBehavior (int impactBehavior)

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

Các tham số

collisionBehavior

Trả bóng

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

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

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

Các tham số

kéo được

Trả bóng

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

công khai MarkerOptions flat (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. 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 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. Giá trị mặc định là false.

Các tham số

không

Trả bóng

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

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

Lấy giá trị alpha đặt riêng cho đối tượng MarkerOptions này.

Trả bóng

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

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

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

Trả bóng

giá trị u của liên kết.

số float công khai getAnchorV ()

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

Trả bóng

giá trị v của liên kết.

public int getCollisionBehavior ()

công khai BitmapDescriptor getIcon ()

Lấy bộ mô tả biểu tượng tuỳ chỉnh được đặt cho đối tượng MarkerOptions này.

Trả bóng

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

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

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

Trả bóng

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

số thực xuất hiện công khai getInfoWindowAnchorV ()

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

Trả bóng

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

công khai LatLng getPosition ()

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

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 ()

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

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 đặt cho đối tượng MarkerOptions này.

Trả bóng

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

công khai Chuỗi getTitle ()

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

Trả bóng

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

public float getZIndex ()

Lấy zIndex được đặt cho đối tượng MarkerOptions này.

Trả bóng

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.

Các tham số

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

Trả bóng

đố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 (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. Giá trị này được xác định trong cùng một hệ toạ độ như điểm neo. Hãy xem anchor(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ố

u	toạ độ u của neo cửa sổ thông tin, theo tỷ lệ chiều rộng của hình ảnh (trong phạm vi [0, 1])
v	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])

Trả bóng

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

công khai boolean isDraggable ()

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

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 cho đối tượng MarkerOptions này.

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.

boolean công khai isVisible ()

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

Trả bóng

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

công khai MarkerOptions vị trí (LatLng latlng)

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

Các tham số

CANNOT TRANSLATE

Trả bóng

đối tượng mà phương thức được gọi với vị trí mới được đặt.

công khai MarkerOptions xoay (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. Khi điểm đánh dấu nằm ngang trên bản đồ, vị trí mặc định sẽ được căn chỉnh theo hướng Bắc và hướng xoay sao cho điểm đánh dấu luôn ở trạng thái 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".

Các tham số

xoay

Trả bóng

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

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

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

Các tham số

đoạn trích

Trả bóng

đố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.

Các tham số

tiêu đề

Trả bóng

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

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

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

Các tham số

hiển thị

Trả bóng

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

công khai MarkerOptions zIndex (float zIndex)

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

Các tham số

zIndex

Trả bóng

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