Đa giác

lớp cuối cùng công khai đa giác mở rộng đối tượng

Một đa giác trên bề mặt trái đất. Một đa giác có thể lồi hoặc lõm, nó có thể kéo dài 180 kinh tuyến và có thể có các lỗ không được lấp đầy. Thuộc tính này có các thuộc tính sau:

Đường viền

Bố cục được xác định bằng danh sách các đỉnh theo thứ tự chiều kim đồng hồ hoặc ngược chiều kim đồng hồ. Không bắt buộc phải xuất hiện điểm đầu tiên và điểm cuối; nếu không, đa giác sẽ tự động đóng. Các đoạn đường được vẽ giữa các điểm liên tiếp trong ngắn hơn hai hướng (phía đông hoặc phía tây).

Lỗ

Lỗ là một khu vực bên trong đa giác chưa được lấp đầy. Một lỗ được chỉ định giống hệt như đường viền. Một lỗ phải được chứa hoàn toàn trong bố cục. Bạn có thể chỉ định nhiều lỗ ( tuy nhiên, chúng tôi không hỗ trợ các lỗ chồng chéo).

Chiều rộng nét vẽ

Độ rộng phân đoạn dòng tính bằng pixel màn hình. Chiều rộng không đổi và không phụ thuộc vào mức thu phóng của máy ảnh. Giá trị mặc định là 10.

Màu nét vẽ

Màu phân đoạn dòng ở định dạng ARGB, cùng định dạng được Color sử dụng. Giá trị mặc định là màu đen (0xff000000).

Loại khớp xương

Kiểu khớp xác định hình dạng sẽ được sử dụng khi kết hợp các đoạn liền kề ở tất cả các đỉnh của đường viền đa giác. Hãy xem JointType để biết các loại kết hợp được hỗ trợ. Giá trị mặc định là DEFAULT.

Mẫu nét vẽ

Dọc (mặc định, được biểu thị bằng null) hoặc một chuỗi các đối tượng PatternItem lặp lại dọc theo đường viền của đa giác. Các loại PatternItem có sẵn: Gap (được xác định theo độ dài khoảng trống tính bằng pixel), Dash (được xác định theo chiều rộng nét vẽ và chiều dài nét đứt tính bằng pixel) và Dot (hình tròn, căn giữa đường viền đa giác, đường kính được xác định theo chiều rộng nét vẽ theo pixel).

Tô màu

Tô màu ở định dạng ARGB, định dạng mà Color sử dụng. Giá trị mặc định là minh bạch (0x00000000). Nếu hình dạng đa giác không được chỉ định chính xác (xem ở trên cho Outline và lỗ), thì sẽ không có màu nền nào được vẽ.

Chỉ mục Z

Thứ tự vẽ đa giác này so với các lớp phủ khác, bao gồm Polyline, Circle, GroundOverlay và TileOverlay, 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ó các chỉ báo z nhỏ hơn. Thứ tự lớp phủ có cùng giá trị chỉ mục z là tùy ý. Giá trị mặc định là 0.

Chế độ hiển thị

Cho biết hình đa giác hiển thị hay không hiển thị, tức là hình đa giác được vẽ trên bản đồ. Một đa giác không hiển thị sẽ không được vẽ, nhưng vẫn 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ị.

Trạng thái trắc địa

Cho biết liệu các đoạn của đa giác có được vẽ dưới dạng trắc địa hay không, chứ không phải là các đường thẳng trên phép chiếu Mercator. Đường trắc địa là đường đi ngắn nhất giữa hai điểm trên bề mặt Trái Đất. Đường cong trắc địa được xây dựng với giả định Trái đất là một hình cầu

Khả năng nhấp

Nếu bạn muốn xử lý các sự kiện được kích hoạt khi người dùng nhấp vào đa giác, hãy đặt thuộc tính này thành true. Bạn có thể thay đổi giá trị này bất kỳ lúc nào. Mặc định là false. Nếu bạn đặt thuộc tính này thành true, ứng dụng của bạn sẽ nhận được thông báo cho GoogleMap.OnPolygonClickListener đã đăng ký qua setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

Thẻ

Object liên kết với đa giác. Ví dụ: Object có thể chứa dữ liệu về nội dung đa giác đại diện. Thao tác này dễ dàng hơn việc lưu trữ một Map<Polygon, Object> riêng biệt. Một ví dụ khác, bạn có thể liên kết mã nhận dạng String tương ứng với mã nhận dạng từ một tập dữ liệu. SDK Google Maps dành cho Android không đọc hay ghi thuộc tính này.

Các phương thức trong lớp này phải được gọi trên luồng giao diện người dùng Android. Nếu không, IllegalStateException sẽ được gửi vào thời gian chạy.

Ví dụ:

GoogleMap map;
 // ... get a map.
 // Add a triangle in the Gulf of Guinea
 Polygon polygon = map.addPolygon(new PolygonOptions()
     .add(new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5), new LatLng(0, 0))
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));
 

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

Để biết thêm thông tin, hãy đọc hướng dẫn dành cho nhà phát triển về Hình dạng.

Tóm tắt phương pháp công khai

boolean	equals(Đối tượng khác) Kiểm tra xem Polygon này có tương đương với một kiểm thử khác hay không.
int	getFillColor() Nhận màu tô của đa giác này.
List<List<LatLng>>	getHoles() Trả về ảnh chụp nhanh các lỗ của đa giác này tại thời điểm này .
Chuỗi	getId() Lấy mã nhận dạng đa giác này.
List<LatLng>	getPoints() Trả về ảnh chụp nhanh của các đỉnh của đa giác này tại thời điểm này .
int	getStrokeColor() Nhận màu nét vẽ của đa giác này.
int	getStrokeJointType() Lấy kiểu khớp nét vẽ được sử dụng ở tất cả các đỉnh của đường viền đa giác.
List<PatternItem>	getStrokePattern() Lấy mẫu nét vẽ của đường viền đa giác này.
số thực dấu phẩy động	getStrokeWidth() Lấy chiều rộng nét vẽ của đa giác này.
Đối tượng	getTag() Lấy thẻ cho đa giác.
số thực dấu phẩy động	getZIndex() Lấy zIndex của đa giác này.
int	hashCode()
boolean	isClickable() Nhận được khả năng nhấp của đa giác.
boolean	isGeodesic() Cho biết liệu mỗi đoạn của đường kẻ có được vẽ dưới dạng trắc địa hay không.
boolean	isHiển thị() Nhận chế độ hiển thị của đa giác này.
void	remove() Xoá đa giác khỏi bản đồ.
void	setClickable (có thể nhấp vào boolean) Đặt khả năng nhấp của đa giác.
void	setFillColor(màu int) Đặt màu tô của đa giác này.
void	setGeodesic(boolean trắc địa) Đặt xem có vẽ từng đoạn đường như dưới dạng trắc địa hay không.
void	setHoles(List<? mở rộng List<LatLng>> lỗ hổng) Đặt các lỗ hổng của đa giác này.
void	setPoints(List<LatLng> điểm) Đặt các điểm của đa giác này.
void	setStrokeColor (màu int) Đặt màu nét vẽ cho đa giác này.
void	setStrokeJointType(int joinType) Đặt loại khớp cho tất cả các đỉnh của đường viền đa giác&3.
void	setStrokePattern(List<PatternItem> hoa văn) Đặt mẫu hoa văn của đường viền đa giác.
void	setStrokeWidth(chiều rộng nổi) Đặt chiều rộng nét vẽ của đa giác này.
void	setTag (Thẻ đối tượng) Đặt thẻ cho đa giác.
void	setVisible(hiển thị boolean) Đặt chế độ hiển thị của đa giác này.
void	setZIndex(nổi zIndex) Đặt zIndex của đa giác này.

Tóm tắt phương pháp kế thừa

Từ lớp java.lang.Object

boolean	equals(Đối số arg0)
lớp cuối cùng Class<?>	getClass()
int	hashCode()
khoảng trống cuối cùng	notifications()
khoảng trống cuối cùng	notifyAll()
Chuỗi	toString()
khoảng trống cuối cùng	wait(long arg0, int arg1)
khoảng trống cuối cùng	wait (args dài)
khoảng trống cuối cùng	wait()

Phương thức công khai

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

Kiểm tra xem Polygon này có tương đương với một kiểm thử khác hay không.

Các tham số

Chi phí khác	Object.

Trả về

• true nếu cả hai đối tượng là cùng một đối tượng, nghĩa là == khác.

public int getFillColor ()

Nhận màu tô của đa giác này.

Trả về

• màu ở định dạng ARGB.

public List<List<LatLng>> getHoles ()

Trả về ảnh chụp nhanh các lỗ của đa giác này tại thời điểm này . Danh sách được trả về là bản sao của danh sách các lỗ nên các thay đổi đối với các lỗ đa giác sẽ không được phản ánh trong danh sách này, cũng như các thay đổi đối với danh sách này sẽ được phản ánh bởi đa giác.

public Chuỗi getId ()

Lấy mã nhận dạng đa giác này. ID sẽ là duy nhất trong số tất cả các Đa giác trên bản đồ.

public List<LatLng> getPoints ()

Trả về ảnh chụp nhanh của các đỉnh của đa giác này tại thời điểm này . Danh sách được trả về là bản sao của danh sách các đỉnh, do đó các thay đổi đối với các đỉnh của đa giác sẽ không được phản ánh trong danh sách này. Các thay đổi đối với danh sách này cũng sẽ không được phản ánh qua đa giác. Để thay đổi các đỉnh của đa giác, hãy gọi setPoints(List).

public int getStrokeColor ()

Nhận màu nét vẽ của đa giác này.

Trả về

• màu ở định dạng ARGB.

public int getStrokeJointType ()

Lấy kiểu khớp nét vẽ được sử dụng ở tất cả các đỉnh của đường viền đa giác. Hãy xem JointType để biết các giá trị có thể áp dụng.

Trả về

• kiểu khớp nét.

public List<PatternItem> getStrokePattern ()

Lấy mẫu nét vẽ của đường viền đa giác này.

Trả về

• kiểu nét vẽ.

công khai nổi getStrokeWidth ()

Lấy chiều rộng nét vẽ của đa giác này.

Trả về

• chiều rộng tính bằng pixel trên màn hình.

công khai Đối tượng getTag ()

Lấy thẻ cho đa giác.

Trả về

• thẻ này nếu thẻ được đặt bằng setTag; null nếu bạn chưa đặt thẻ nào.

float công khai getZIndex ()

Lấy zIndex của đa giác này.

Trả về

• zIndex của đa giác.

public int hashCode ()

boolean công khai isClickable ()

Nhận được khả năng nhấp của đa giác. Nếu có thể nhấp được đa giác, ứng dụng của bạn sẽ nhận được thông báo gửi đến GoogleMap.OnPolygonClickListener khi người dùng nhấp vào đa giác. Trình nghe sự kiện được đăng ký qua setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

Trả về

• true nếu đa giác có thể nhấp được; nếu không, trả về false.

boolean công khai isGeodesic ()

Cho biết liệu mỗi đoạn của đường kẻ có được vẽ dưới dạng trắc địa hay không.

Trả về

• true nếu mỗi đoạn được vẽ dưới dạng một trắc địa; false nếu mỗi đoạn được vẽ dưới dạng một đường thẳng trên phép chiếu Mercator.

boolean công khai isVisible ()

Nhận chế độ hiển thị của đa giác này.

Trả về

• chế độ hiển thị đa giác này.

công khai khoảng trống xóa ()

Xoá đa giác khỏi bản đồ. Sau khi xoá một đa giác, bạn sẽ không xác định được hành vi của tất cả các phương thức đa giác.

public void setClickable (boolean có thể nhấp)

Đặt khả năng nhấp của đa giác. Nếu có thể nhấp được đa giác, ứng dụng của bạn sẽ nhận được thông báo gửi đến GoogleMap.OnPolygonClickListener khi người dùng nhấp vào đa giác. Trình nghe sự kiện được đăng ký qua setOnPolygonClickListener(GoogleMap.OnPolygonClickListener).

Các tham số

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

public void setFillColor (màu sắc)

Đặt màu tô của đa giác này.

Các tham số

màu	màu ở định dạng ARGB

public void setGeodesic (boolean Geodesic)

Đặt xem có vẽ từng đoạn đường như dưới dạng trắc địa hay không.

Các tham số

trắc địa	nếu true, thì mỗi đoạn được vẽ dưới dạng một trắc địa; nếu false, mỗi đoạn sẽ được vẽ dưới dạng một đường thẳng trên phép chiếu Mercator.

public void setHoles (List<? mở rộng List<LatLng>> lỗ hổng)

Đặt các lỗ hổng của đa giác này. Phương thức này sẽ sao chép các lỗ trống, vì vậy, các đột biến tiếp theo đối với holes sẽ không ảnh hưởng đến đa giác này.

Các tham số

lỗ	danh sách các lỗ, trong đó một lỗ là danh sách LatLng.

public void setPoints (List<LatLng> điểm)

Đặt các điểm của đa giác này. Phương thức này sẽ sao chép các điểm, vì vậy, các đột biến tiếp theo đối với points sẽ không ảnh hưởng đến đa giác này.

Các tham số

điểm	danh sách LatLng là đỉnh của đa giác.

public void setStrokeColor (int color)

Đặt màu nét vẽ cho đa giác này.

Các tham số

màu	màu ở định dạng ARGB

public void setStrokeJointType (int joinType)

Đặt loại khớp cho tất cả các đỉnh của đường viền đa giác&3.

Hãy xem JointType để biết các giá trị được phép. Giá trị mặc định DEFAULT sẽ được sử dụng nếu loại chung là không xác định hoặc không phải là một trong các giá trị được phép.

Các tham số

kiểu khớp	kiểu khớp nét.

public void setStrokePattern (List<PatternItem> hoa văn)

Đặt mẫu hoa văn của đường viền đa giác. Mẫu nét vẽ mặc định là một khối đồng nhất, được biểu thị bằng null.

Các tham số

hình mở khóa	kiểu nét vẽ.

public void setStrokeWidth (nổi chiều rộng)

Đặt chiều rộng nét vẽ của đa giác này.

Các tham số

chiều rộng	chiều rộng tính bằng pixel hiển thị.

public void setTag (Thẻ đối tượng)

Đặt thẻ cho đa giác.

Bạn có thể sử dụng thuộc tính này để liên kết một Object tùy ý với đa giác này. Ví dụ: Object có thể chứa dữ liệu về nội dung đa giác đại diện. Thao tác này dễ dàng hơn so với việc lưu trữ một Map<Polygon, Object> riêng biệt. Ví dụ khác: bạn có thể liên kết một mã nhận dạng String tương ứng với mã đó từ một tập dữ liệu. SDK Google Maps dành cho Android không đọc hay ghi thuộc tính này. Bạn có trách nhiệm gọi setTag(null) để xoá thẻ khi không cần đến nữa để ngăn rò rỉ bộ nhớ trong ứng dụng.

Các tham số

tag	Nếu giá trị là rỗng, thẻ này sẽ bị xoá.

public void setVisible (boolean tối ưu hoá)

Đặt chế độ hiển thị của đa giác này. Khi không hiển thị, đa giác không được vẽ, nhưng sẽ giữ lại tất cả các thuộc tính khác.

Các tham số

hiển thị	nếu true, thì đa giác hiển thị; nếu false thì không.

public void setZIndex (float zIndex)

Đặt zIndex của đa giác này. Các đa giác có chỉ số zIndic cao hơn được vẽ phía trên các đa giác có chỉ mục thấp hơn.

Các tham số

Chỉ mục zIndex	zIndex của đa giác này.