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.

GroundOverlayOptions

lớp cuối cùng công khai GroundOverlayOptions mở rộng Đối tượng
triển khai Parcelable

Xác định các tuỳ chọn cho lớp phủ mặt đất.

Tóm tắt hằng số

float NO_DIMENSION Gắn cờ cho khi không có phương diện nào được chỉ định cho chiều cao.

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

GroundOverlayOptions()

Tạo một nhóm tuỳ chọn lớp phủ mặt đất mới.

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

GroundOverlayOptions	anchor(số thực dấu phẩy động u, số thực v) Chỉ định neo.
GroundOverlayOptions	bạc(gối nổi) Chỉ định góc phương vị của lớp phủ mặt đất theo độ theo chiều kim đồng hồ từ hướng bắc.
GroundOverlayOptions	có thể nhấp(boolean có thể nhấp) Chỉ định xem liệu lớp phủ trên mặt đất có thể nhấp vào được hay không
float	Hàm getAnchorU() Neo tương đối theo chiều ngang; `0.0` và `1.0` lần lượt biểu thị các cạnh trái và phải.
float	Hàm getAnchorV() Neo tương đối theo chiều dọc; `0.0` và `1.0` lần lượt biểu thị các cạnh trên và dưới.
float	getBearing() Lấy góc phương vị cho đối tượng `GroundOverlayOptions` này.
LatLngBounds	Hàm getBounds() Lấy các giới hạn được đặt cho đối tượng `GroundOverlayOptions` này.
float	getHeight() Lấy chiều cao được đặt cho đối tượng `GroundOverlayOptions` này.
BitmapDescriptor	getImage() Lấy bộ mô tả hình ảnh cho đối tượng `GroundOverlayOptions` này.
LatLng	Hàm getLocation() Lấy vị trí được đặt cho đối tượng `GroundOverlayOptions` này.
float	Hàm getTransparency() Lấy độ trong suốt được đặt cho đối tượng `GroundOverlayOptions` này.
float	getWidth() Lấy chiều rộng được đặt cho đối tượng `GroundOverlayOptions` này.
float	getZIndex() Lấy zIndex được đặt cho đối tượng `GroundOverlayOptions` này.
GroundOverlayOptions	image(BitmapDescriptor imageDescriptor) Chỉ định hình ảnh cho lớp phủ mặt đất này.
boolean	isClickable() Lấy chế độ cài đặt khả năng nhấp cho đối tượng `GroundOverlayOptions` này.
boolean	isVisible() Lấy chế độ cài đặt chế độ hiển thị cho đối tượng `GroundOverlayOptions` này.
GroundOverlayOptions	position(vị trí LatLng, chiều rộng số thực) Chỉ định vị trí cho lớp phủ trên mặt đất này bằng cách sử dụng một điểm neo (`LatLng`) và chiều rộng (tính bằng mét).
GroundOverlayOptions	vị trí(vị trí LatLng, chiều rộng số thực, chiều cao số thực) Chỉ định vị trí cho lớp phủ trên mặt đất này bằng cách sử dụng điểm neo (`LatLng`), chiều rộng và chiều cao (cả hai đều tính bằng mét).
GroundOverlayOptions	positionFromBounds(giới hạn LatLngBounds) Chỉ định vị trí cho lớp phủ mặt đất này.
GroundOverlayOptions	độ trong suốt(độ trong suốt nổi) Chỉ định độ trong suốt của lớp phủ mặt đất.
GroundOverlayOptions	visible(boolean hiển thị) Chỉ định chế độ hiển thị cho lớp phủ mặt đất.
GroundOverlayOptions	zIndex(chỉ mục số thực dấu phẩy động) Chỉ định zIndex của lớp phủ mặt đất, tức là thứ tự vẽ lớp phủ.

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)

Hằng số

công khai tĩnh cuối cùng float NO_DIMENSION

Gắn cờ cho khi không có phương diện nào được chỉ định cho chiều cao.

Giá trị không đổi: -1,0

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

công khai GroundOverlayOptions ()

Tạo một nhóm tuỳ chọn lớp phủ mặt đất mới.

Phương thức công khai

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

Chỉ định neo.

Neo căn chỉnh với vị trí của lớp phủ mặt đất.

Điểm neo được chỉ định trong không gian liên tục 2D, trong đó (0,0), (1,0), (0,1) và (1,1) biểu thị các góc trên cùng bên trái, trên cùng bên phải, dưới cùng bên trái và dưới cùng bên phải.

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

Các tham số

u	toạ độ u của neo
v	toạ độ v của neo

Trả bóng

đối tượng GroundOverlayOptions này với một bộ neo mới.

công khai GroundOverlayOptions bạc (bạc nổi)

Chỉ định góc phương vị của lớp phủ mặt đất theo độ theo chiều kim đồng hồ từ hướng bắc. Việc xoay được thực hiện đối với điểm neo. Nếu bạn không chỉ định, giá trị mặc định sẽ là 0 (tức là hướng lên trên hình ảnh hướng về phía bắc).

Lưu ý rằng giới hạn kinh độ-vĩ độ sẽ áp dụng trước khi xoay.

Các tham số

đang mang	ổ trục theo độ theo chiều kim đồng hồ từ hướng bắc. Các giá trị nằm ngoài phạm vi [0, 360) sẽ được chuẩn hoá.

Trả bóng

đối tượng GroundOverlayOptions này với một bộ vòng bi mới.

công khai GroundOverlayOptions có thể nhấp (boolean có thể nhấp)

Chỉ định xem liệu lớp phủ trên mặt đất có thể nhấp vào được hay không Khả năng nhấp mặc định là false.

Các tham số

có thể nhấp	Chế độ cài đặt mới về khả năng nhấp.

Trả bóng

đối tượng GroundOverlayOptions này với chế độ cài đặt mới về khả năng nhấp.

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

Neo tương đối theo chiều ngang; 0.0 và 1.0 lần lượt biểu thị các cạnh trái và phải. Các giá trị neo khác được nội suy tương ứng.

Trả bóng

vị trí neo tương đối theo cạnh ngang.

số float công khai getAnchorV ()

Neo tương đối theo chiều dọc; 0.0 và 1.0 lần lượt biểu thị các cạnh trên và dưới. Các giá trị neo khác được nội suy tương ứng.

Trả bóng

vị trí neo tương đối theo cạnh dọc.

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

Lấy góc phương vị cho đối tượng GroundOverlayOptions này.

Trả bóng

góc phương vị của lớp phủ mặt đất.

công khai LatLngBounds getBounds ()

Lấy các giới hạn được đặt cho đối tượng GroundOverlayOptions này.

Trả bóng

ranh giới của lớp phủ mặt đất. Giá trị này sẽ là null nếu bạn đặt vị trí bằng position(LatLng, float) hoặc position(LatLng, float, float)

public float getHeight ()

Lấy chiều cao được đặt cho đối tượng GroundOverlayOptions này.

Trả bóng

chiều cao của lớp phủ mặt đất.

công khai BitmapDescriptor getImage ()

Lấy bộ mô tả hình ảnh cho đối tượng GroundOverlayOptions này.

Trả bóng

BitmapDescriptor đại diện cho hình ảnh của lớp phủ mặt đất.

công khai LatLng getLocation ()

Lấy vị trí được đặt cho đối tượng GroundOverlayOptions này.

Trả bóng

vị trí để đặt neo của lớp phủ mặt đất. Giá trị này sẽ là null nếu bạn đặt vị trí bằng positionFromBounds(LatLngBounds).

số thực dấu phẩy động công khai getTransparency ()

Lấy độ trong suốt được đặt cho đối tượng GroundOverlayOptions này.

Trả bóng

độ trong suốt của lớp phủ mặt đất.

public float getWidth ()

Lấy chiều rộng được đặt cho đối tượng GroundOverlayOptions này.

Trả bóng

chiều rộng của lớp phủ mặt đất.

public float getZIndex ()

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

Trả bóng

zIndex của lớp phủ mặt đất.

công khai GroundOverlayOptions hình ảnh (BitmapDescriptor imageDescriptor)

Chỉ định hình ảnh cho lớp phủ mặt đất này.

Để tải hình ảnh dưới dạng hoạ tiết (dùng để vẽ hình ảnh trên bản đồ), bạn phải chuyển đổi hình ảnh đó thành hình ảnh với các cạnh là luỹ thừa của 2. Mục đích của việc này là có thể tạo mipmap để hiển thị hoạ tiết ở nhiều mức thu phóng – xem Mipmap (Wikipedia) để biết thông tin chi tiết. Do đó, để tiết kiệm bộ nhớ bằng cách tránh lượt chuyển đổi này, bạn nên sử dụng kích thước của hình ảnh là luỹ thừa của 2.

Các tham số

imageDescriptor	`BitmapDescriptor` để sử dụng cho lớp phủ mặt đất này

Trả bóng

đối tượng GroundOverlayOptions này với một nhóm hình ảnh mới.

công khai boolean isClickable ()

Lấy chế độ cài đặt khả năng nhấp cho đối tượng GroundOverlayOptions này.

Trả bóng

true nếu lớp phủ mặt đất có thể nhấp vào; false nếu không thể nhấp vào.

boolean công khai isVisible ()

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

Trả bóng

true nếu lớp phủ mặt đất này hiển thị; false nếu không hiển thị.

công khai GroundOverlayOptions vị trí (LatLng, chiều rộng nổi)

Chỉ định vị trí cho lớp phủ trên mặt đất này bằng cách sử dụng một điểm neo (LatLng) và chiều rộng (tính bằng mét). Chiều cao sẽ được điều chỉnh cho phù hợp để duy trì tỷ lệ khung hình.

Các tham số

vị trí	vị trí trên bản đồ `LatLng` mà điểm neo trong hình ảnh đã cho sẽ được giữ cố định. Neo sẽ vẫn cố định ở vị trí trên mặt đất khi áp dụng các phép biến đổi (ví dụ: setKích thước, setBearing, v.v.).
chiều rộng	chiều rộng của lớp phủ (tính bằng mét). Chiều cao sẽ được xác định tự động dựa trên tỷ lệ khung hình của hình ảnh.

Trả bóng

đối tượng GroundOverlayOptions này với một vị trí mới đã đặt.

Gửi

IllegalArgumentException	nếu điểm neo là `null`
IllegalArgumentException	nếu chiều rộng là số âm
IllegalStateException	nếu vị trí đã được đặt bằng `positionFromBounds(LatLngBounds)`

công khai GroundOverlayOptions vị trí (LatLng, chiều rộng nổi, chiều cao nổi)

Chỉ định vị trí cho lớp phủ trên mặt đất này bằng cách sử dụng điểm neo (LatLng), chiều rộng và chiều cao (cả hai đều tính bằng mét). Khi hiển thị, hình ảnh sẽ được điều chỉnh theo tỷ lệ cho phù hợp với kích thước được chỉ định.

Các tham số

vị trí	vị trí trên bản đồ `LatLng` mà điểm neo trong hình ảnh đã cho sẽ được giữ cố định. Neo sẽ vẫn cố định ở vị trí trên mặt đất khi áp dụng các phép biến đổi (ví dụ: setKích thước, setBearing, v.v.).
chiều rộng	chiều rộng của lớp phủ (tính bằng mét)
độ cao	chiều cao của lớp phủ (tính bằng mét)

Trả bóng

đối tượng GroundOverlayOptions này với một vị trí mới đã đặt.

Gửi

IllegalArgumentException	nếu điểm neo là `null`
IllegalArgumentException	nếu chiều rộng hoặc chiều cao là số âm
IllegalStateException	nếu vị trí đã được đặt bằng `positionFromBounds(LatLngBounds)`

công khai GroundOverlayOptions positionFromBounds (LatLngBounds)

Chỉ định vị trí cho lớp phủ mặt đất này.

Các tham số

ranh giới	một `LatLngBounds` để đặt lớp phủ mặt đất

Trả bóng

đối tượng GroundOverlayOptions này với một vị trí mới đã đặt.

Gửi

IllegalStateException	nếu vị trí đã được đặt bằng cách sử dụng `position(LatLng, float)` hoặc `position(LatLng, float, float)`

công khai GroundOverlayOptions độ trong suốt (độ trong suốt nổi)

Chỉ định độ trong suốt của lớp phủ mặt đất. Độ trong suốt mặc định là 0 (không rõ ràng).

Các tham số

tính minh bạch	một số thực trong phạm vi `[0..1]`, trong đó `0` có nghĩa là lớp phủ trên mặt đất không trong suốt và `1` có nghĩa là lớp phủ trên mặt đất trong suốt.

Trả bóng

đối tượng GroundOverlayOptions này với chế độ cài đặt mới về độ trong suốt.

Gửi

IllegalArgumentException	nếu độ trong suốt nằm ngoài khoảng [0..1].

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

Chỉ định chế độ hiển thị cho lớp phủ mặt đất. Chế độ hiển thị mặc định là true.

Các tham số

hiển thị

Trả bóng

đối tượng GroundOverlayOptions này có chế độ hiển thị mới.

công khai GroundOverlayOptions zIndex (float zIndex)

Chỉ định zIndex của lớp phủ mặt đất, tức là thứ tự vẽ lớp phủ. Hãy xem tài liệu ở đầu lớp này để biết thêm thông tin về zIndex.

Các tham số

zIndex

Trả bóng

đối tượng GroundOverlayOptions này với một tập hợp zIndex mới.