Lớp phủ xếp kề

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

Lớp phủ xếp kề là một tập hợp hình ảnh được hiển thị trên các ô bản đồ cơ sở. Những ô này có thể trong suốt, cho phép bạn thêm đối tượng vào bản đồ hiện có. Lớp phủ xếp kề có các thuộc tính sau:

Nhà cung cấp thẻ thông tin
TileProvider cung cấp các hình ảnh dùng trong lớp phủ xếp kề. Bạn phải chỉ định trình cung cấp thẻ thông tin trước khi thêm vào bản đồ. Bạn không thể thay đổi trình cung cấp thẻ thông tin sau khi thêm. Tuy nhiên, bạn có thể sửa đổi hành vi của trình cung cấp thẻ thông tin để trả về các hình ảnh khác nhau cho những toạ độ cụ thể. Nếu các thẻ thông tin do trình cung cấp thẻ thông tin cung cấp thay đổi, bạn phải gọi clearTileCache() sau đó để đảm bảo rằng các thẻ thông tin trước đó không còn hiển thị nữa.
Chỉ mục Z
Thứ tự vẽ lớp phủ ô này tương ứng với các lớp phủ khác (bao gồm GroundOverlay, Circle, PolylinePolygon nhưng không phải Marker). Một lớp phủ có chỉ mục z lớn hơn được vẽ trên các lớp phủ có chỉ mục z nhỏ hơn. Thứ tự của các lớp phủ có cùng chỉ mục z là tuỳ ý. zIndex mặc định là 0.
Sự minh bạch
Tính minh bạch của lớp phủ thẻ thông tin trong dải ô [0..1], trong đó 0 có nghĩa là lớp phủ không trong suốt và 1 có nghĩa là lớp phủ hoàn toàn trong suốt. Nếu bitmap được chỉ định đã có một phần trong suốt, thì độ trong suốt của từng pixel sẽ được điều chỉnh theo tỷ lệ tương ứng (ví dụ: nếu một pixel trong bitmap có giá trị alpha là 200 và bạn chỉ định độ trong suốt của lớp phủ thẻ thông tin là 0, 25, thì pixel sẽ hiển thị trên màn hình với giá trị alpha là 150). Thông số kỹ thuật của thuộc tính này là không bắt buộc và độ trong suốt mặc định là 0 (độ mờ).
Chế độ hiển thị
Cho biết liệu lớp phủ xếp kề hiện hay ẩn, tức là liệu lớp phủ đó có được vẽ trên bản đồ hay không. Lớp phủ xếp kề không hiển thị sẽ không được vẽ mà giữ lại tất cả các thuộc tính khác của nó. Giá trị mặc định là true, tức là hiển thị.

Bạn chỉ được gọi các phương thức trong lớp này trên luồng chính. Nếu không, IllegalStateException sẽ xảy ra.

Toạ độ xếp kề

Xin lưu ý rằng bạn có thể chiếu thế giới bằng cách sử dụng phép chiếu này (xem Wikipedia) với phía bên trái (hướng Tây) của bản đồ tương ứng với – -180 độ kinh độ và cạnh bên phải (đông) của bản đồ tương ứng với 180 độ kinh độ. Để làm hình vuông của bản đồ, cạnh trên cùng (bắc) của bản đồ tương ứng với 85,0511 độ vĩ độ và cạnh dưới cùng (phía nam) của bản đồ tương ứng với -85,0511 độ vĩ độ. Các khu vực nằm ngoài phạm vi vĩ độ này không được hiển thị.

Ở mỗi mức thu phóng, bản đồ được chia thành các ô và chỉ các ô chồng lên màn hình mới được tải xuống và kết xuất. Mỗi ô là hình vuông và bản đồ được chia thành các ô như sau:

  • Ở mức thu phóng 0, một ô đại diện cho toàn bộ thế giới. Toạ độ của ô đó là (x, y) = (0, 0).
  • Ở cấp độ thu phóng 1, thế giới được chia thành 4 ô xếp theo lưới 2 x 2.
  • ...
  • Ở mức thu phóng N, thế giới được chia thành 4N ô được sắp xếp trong một lưới 2N x 2N.
Xin lưu ý rằng mức thu phóng tối thiểu mà máy ảnh hỗ trợ (có thể phụ thuộc vào nhiều yếu tố) là GoogleMap.getMinZoomLevel và mức thu phóng tối đa là GoogleMap.getMaxZoomLevel.

Toạ độ của các ô được đo từ góc trên cùng bên trái (tây bắc) của bản đồ. Ở mức thu phóng N, giá trị x của toạ độ thẻ thông tin nằm trong khoảng từ 0 đến 2N – 1 và tăng từ tây sang đông, còn giá trị y dao động từ 0 đến 2N – 1 và tăng từ bắc xuống nam.

Ví dụ:

GoogleMap map; // ... get a map.
 TileProvider tileProvider; // ... create a tile provider.
 TileOverlay tileOverlay = map.addTileOverlay(
     new TileOverlayOptions().tileProvider(tileProvider));
 

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

void
Hàm clearTileCache()
Xoá bộ nhớ đệm của thẻ thông tin để yêu cầu lại tất cả thẻ thông tin qua TileProvider.
boolean
bằng(Đối tượng khác)
Kiểm tra xem TileOverlay này có bằng với một giá trị khác hay không.
boolean
getFadeIn()
Xem xem liệu các ô lớp phủ có nên mờ dần hay không.
Chuỗi
getId()
Lấy mã nhận dạng của lớp phủ ô này.
float
Hàm getTransparency()
Xem độ trong suốt của lớp phủ ô này.
float
getZIndex()
Lấy zIndex của lớp phủ ô này.
int
boolean
isVisible()
Xem chế độ hiển thị của lớp phủ ô này.
void
xoá()
Xoá lớp phủ ô này khỏi bản đồ.
void
setFadeIn(boolean fadeIn)
Đặt xem ô lớp phủ có nên mờ dần hay không.
void
setTransparency(độ trong suốt nổi)
Đặt độ trong suốt của lớp phủ xếp kề này.
void
setVisible(boolean hiển thị)
Đặt chế độ hiển thị của lớp phủ xếp kề này.
void
setZIndex(số thực dấu phẩy động zIndex)
Đặt zIndex của lớp phủ xếp kề này.

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

Phương thức công khai

public void clearTileCache ()

Xoá bộ nhớ đệm của thẻ thông tin để yêu cầu lại tất cả thẻ thông tin qua TileProvider. Các ô hiện tại từ lớp phủ ô này cũng sẽ bị xoá khỏi bản đồ sau khi gọi phương thức này. API duy trì một bộ nhớ đệm nhỏ trong bộ nhớ đệm của các thẻ thông tin. Nếu muốn lưu thẻ thông tin vào bộ nhớ đệm trong thời gian dài hơn, bạn nên triển khai bộ nhớ đệm trên ổ đĩa.

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

Kiểm tra xem TileOverlay 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.

công khai boolean getFadeIn ()

Xem xem liệu các ô lớp phủ có nên mờ dần hay không.

Trả bóng
  • true nếu các thẻ thông tin sẽ mờ dần; false nếu không mờ.

công khai Chuỗi getId ()

Lấy mã nhận dạng của lớp phủ ô này.

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

Xem độ trong suốt của lớp phủ ô này.

Trả bóng
  • độ trong suốt của lớp phủ xếp kề này.

public float getZIndex ()

Lấy zIndex của lớp phủ ô này.

Trả bóng
  • zIndex của lớp phủ xếp kề.

public int hashCode ()

boolean công khai isVisible ()

Xem chế độ hiển thị của lớp phủ ô này. Xin lưu ý rằng thao tác này không cho biết liệu lớp phủ xếp kề có thực sự nằm trong khung nhìn của màn hình hay không, mà là liệu lớp phủ có được vẽ hay không nếu lớp phủ đó nằm trong khung nhìn của màn hình.

Trả bóng
  • khả năng hiển thị của lớp phủ xếp kề này.

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

Xoá lớp phủ ô này khỏi bản đồ.

công khai khoảng trống setFadeIn (boolean fadeIn)

Đặt xem ô lớp phủ có nên mờ dần hay không.

Các tham số
fadeIn true để làm mờ các thẻ thông tin; false để kết xuất thẻ thông tin ngay lập tức.

công khai khoảng trống setTransparency (độ trong suốt nổi)

Đặt độ trong suốt của lớp phủ xếp kề này. Hãy xem tài liệu ở đầu lớp này để biết thêm thông tin.

Các tham số
tính minh bạch một số thực dấu phẩy động trong phạm vi [0..1], trong đó 0 có nghĩa là lớp phủ thẻ thông tin mờ và 1 có nghĩa là lớp phủ thẻ thông tin trong suốt.

public void setVisible (boolean visible)

Đặt chế độ hiển thị của lớp phủ xếp kề này. Khi không hiển thị, lớp phủ thẻ thông tin sẽ không được vẽ, nhưng vẫn giữ tất cả các thuộc tính khác. Theo mặc định, lớp phủ ô hiển thị.

Các tham số
hiển thị true để hiển thị lớp phủ này; false để ẩn lớp phủ này.

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

Đặt zIndex của lớp phủ xếp kề này. Hãy xem tài liệu ở đầu lớp này để biết thêm thông tin.

Các tham số
zIndex zIndex của lớp phủ xếp kề này.