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 các hình ảnh được hiển thị trên các ô bản đồ cơ sở. Các ô này có thể minh bạch, cho phép bạn thêm đối tượng địa lý 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 gạch lát
TileProvider cung cấp những hình ảnh được sử dụng trong lớp phủ thẻ thông tin. Bạn phải chỉ định trình cung cấp thẻ thông tin trước khi thêm vào bản đồ. Trình cung cấp thẻ thông tin không được là đã thay đổi sau khi được thêm vào; 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 các toạ độ cụ thể. Nếu ô do ô thay đổi nhà cung cấp, bạn phải gọi clearTileCache() sau đó để đảm bảo rằng các ô trước không còn hiển thị nữa.
Chỉ số Z
Thứ tự vẽ lớp phủ này so với các lớp phủ khác (bao gồm GroundOverlay, Circle, Polyline và Polygon nhưng không Marker). Lớp phủ có chỉ số z lớn hơn được vẽ trên lớp phủ có chỉ số nhỏ hơn chỉ số z. 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
Độ trong suốt của lớp phủ ô trong dải ô [0..1], trong đó 0 có nghĩa là lớp phủ mờ đục và 1 có nghĩa là lớp phủ hoàn toàn trong suốt. Nếu giá trị được chỉ định bitmap đã trong suốt một phần, độ trong suốt của từng pixel sẽ được điều chỉnh theo tỷ lệ theo đó (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ủ ô là 0,25, thì pixel sẽ được kết xuất trên màn hình có 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 (không rõ ràng).
Chế độ hiển thị
Cho biết lớp phủ thẻ thông tin hiển thị hay không nhìn thấy, tức là liệu lớp phủ này có được vẽ trên bản đồ. Lớp phủ thẻ thông tin ẩn sẽ không được vẽ nhưng vẫn giữ lại mọi thuộc tính khác. Chiến lược phát hành đĩ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 làm như vậy, IllegalStateException.

Toạ độ ô

Lưu ý rằng thế giới được dự kiến bằng phép chiếu Mercator (xem Wikipedia) với phía bên trái (tây) của bản đồ tương ứng với kinh độ -180 độ và phía bên phải (đông) của bản đồ tương ứng với 180 độ kinh độ. Để làm cho bản đồ là hình vuông, cạnh trên cùng (bắc) của bản đồ tương ứng với vĩ độ 85,0511 và phía dưới (phía nam) của bản đồ tương ứng đến -85,0511 độ vĩ độ. Các khu vực nằm ngoài phạm vi vĩ độ này sẽ 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 đượ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 thẻ thông tin đại diện cho toàn bộ thế giới. Toạ độ của ô đó là (x, y) = (0, 0).
  • Ở mức thu phóng 1, thế giới được chia thành 4 ô được sắp 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 theo 2N lưới 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 đồ. Tại mức thu phóng N, giá trị x của toạ độ ô nằm trong khoảng từ 0 đến 2N – 1 và tăng từ tây sang đông và giá trị y nằm trong khoả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 về phương thức công khai

void
clearTileCache()
Xoá bộ nhớ đệm của thẻ thông tin để tất cả thẻ thông tin được yêu cầu lại từ TileProvider.
boolean
bằng(Đối tượng khác)
Kiểm thử xem TileOverlay này có bằng một mã khác hay không.
boolean
getFadeIn()
Xem liệu các thẻ thông tin lớp phủ có rõ dần hay không.
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
getTransparency()
Xem độ trong suốt của lớp phủ thẻ thông tin này.
số thực dấu phẩy động
getZIndex()
Lấy zIndex của lớp phủ ô này.
int
hashCode()
boolean
isVisible()
Xem chế độ hiển thị của lớp phủ ô này.
void
remove()
Xoá lớp phủ xếp kề này khỏi bản đồ.
void
setFadeIn(boolean fadeIn)
Đặt xem có nên làm mờ các thẻ thông tin lớp phủ hay không.
void
setTransparency(độ trong suốt của số thực)
Đặt độ trong suốt của lớp phủ ô này.
void
setVisible(boolean visible)
Đặt chế độ hiển thị của lớp phủ ô này.
void
setZIndex(nổi zIndex)
Đặt zIndex của lớp phủ ô này.

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

Phương thức công khai

công khai trống clearTileCache ()

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

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

Kiểm thử xem TileOverlay này có bằng một mã khác hay không.

Tham số
Chi phí khác Object.
Giá trị trả về
  • true nếu cả hai đối tượng đều là cùng một đối tượng, tức là đối tượng này == khác.

công khai boolean getFadeIn ()

Xem liệu các thẻ thông tin lớp phủ có rõ dần hay không.

Giá trị trả về
  • true nếu các thẻ thông tin mờ dần; false nếu không.

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

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

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

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

Giá trị trả về
  • độ trong suốt của lớp phủ ô này.

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

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

Giá trị trả về
  • zIndex của lớp phủ ô.

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

công khai boolean isVisible ()

Xem chế độ hiển thị của lớp phủ ô này. Lưu ý rằng biến này sẽ không trả về cho dù thẻ thông tin thực sự nằm trong khung nhìn của màn hình, nhưng liệu lớp phủ có được vẽ nếu có trong khung nhìn của màn hình.

Giá trị trả về
  • chế độ hiển thị của lớp phủ ô này.

công khai trống xoá ()

Xoá lớp phủ xếp kề này khỏi bản đồ.

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

Đặt xem có nên làm mờ các thẻ thông tin lớp phủ hay không.

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

công khai trống setTransparency (độ trong suốt của độ chính xác đơn)

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

Tham số
độ trong suốt số thực dấu phẩy động trong dải ô [0..1], trong đó 0 có nghĩa là thẻ thông tin lớp phủ mờ và 1 có nghĩa là lớp phủ ô trong suốt.

công khai trống setVisible (boolean visible)

Đặt chế độ hiển thị của lớp phủ ô này. Khi không hiển thị, lớp phủ ô không được vẽ mà chỉ hiển thị giữ lại mọi thuộc tính khác của nó. Theo mặc định, các lớp phủ ô sẽ hiển thị.

Tham số
hiển thị true để hiển thị lớp phủ này; false để ẩn đi.

công khai trống setZIndex (nổi zIndex)

Đặt zIndex của lớp phủ ô này. Hãy xem tài liệu ở đầu lớp học này để biết thêm của bạn.

Tham số
zIndex zIndex của lớp phủ ô này.