Đa giác

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ể trải dài 180 kinh tuyến và có thể có các lỗ chưa được lấp đầy. Lớp này có các thuộc tính sau:

Đường viền

Đường viền được xác định bằng một danh sách các đỉnh theo chiều kim đồng hồ hoặc ngược chiều kim đồng hồ. Nó không cần thiết để điểm bắt đầu và điểm kết thúc trùng nhau; nếu không, đa giác sẽ sẽ tự động đóng. Các đoạn thẳng được vẽ giữa các điểm liên tiếp trong hai hướng (đông hoặc tây).

Lỗ

Lỗ hổng là một vùng bên trong đa giác không được lấp đầy. Lỗ được chỉ định chính xác bằng giống như cách phác thảo. Phải chứa hoàn toàn một lỗ trong đường viền. Nhiều lỗ có thể được chỉ định, tuy nhiên các lỗ chồng chéo không được hỗ trợ.

Độ rộng nét chữ

Chiều rộng của đoạn đườ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 chiều rộng của camera mức thu phóng. Giá trị mặc định là 10.

Màu nét chữ

Màu của đoạn đường kẻ ở định dạng ARGB, cùng định dạng mà Color sử dụng. Giá trị mặc định là màu đen (0xff000000).

Loại khớp đột quỵ

Kiểu khớp xác định hình dạng sẽ được sử dụng khi nối các đoạn đường liền kề đỉnh của đường viền đa giác. Xem JointType để biết các loại liên kết được hỗ trợ. Chiến lược phát hành đĩa đơn giá trị mặc định là DEFAULT.

Mẫu nét chữ

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

Màu nền

Tô màu ở định dạng ARGB, cùng định dạng mà Color sử dụng. Chiến lược phát hành đĩa đơn giá trị mặc định là trong suốt (0x00000000). Nếu hình đa giác không được chỉ định chính xác (xem Đường viền và Lỗ ở trên), thì sẽ không có màu nền nào được vẽ.

Chỉ số 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 Marker giây. 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 giá trị chỉ mục z là tuỳ ý. Mặc định là 0.

Chế độ hiển thị

Cho biết đa giác có thể nhìn thấy hay không nhìn thấy được, tức là nó có được vẽ trên bản đồ hay không. Một đa giác vô hình không được vẽ nhưng vẫn giữ lại tất cả thuộc tính khác của nó. Mặc định là true, tức là hiển thị.

Tình trạng trắc địa

Cho biết có nên vẽ các đoạn của đa giác dưới dạng đường trắc địa chứ không phải 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 đường thẳng các điểm trên bề mặt Trái Đất. Đường cong trắc địa được xây dựng giả định Trái đất là 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 hình đ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. Giá trị mặc định là false. Nếu trường hợp này được thiết lập thành true, thì ứng dụng của bạn sẽ nhận được thông báo đến GoogleMap.OnPolygonClickListener được đăng ký đến hết 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ề những gì đa giác đại diện. Cách này dễ hơn so với 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ã String tương ứng với ID từ tập dữ liệu. SDK Google Maps dành cho Android không đọc hoặc viết 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 trong 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 tài liệu dành cho nhà phát triển Hình dạng của chúng tôi.