Trang này được dịch bởi Cloud Translation API.

Hình nhiều đường

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

Nhiều đường kẻ là danh sách các điểm, trong đó các đoạn đường được vẽ giữa các điểm liên tiếp. Hình nhiều đường có các thuộc tính sau:

Tính điểm: Các đỉnh của đường thẳng. Các đoạn đường được vẽ giữa các điểm liên tiếp. Một đa giác không đóng theo mặc định; để tạo thành nhiều đa, các điểm bắt đầu và điểm kết thúc phải giống nhau.
Chiều rộng: Độ 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: 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).
Giới hạn bắt đầu/kết thúc: Xác định hình dạng được sử dụng ở đầu hoặc cuối của nhiều đường. Các loại giới hạn được hỗ trợ: ButtCap, SquareCap, RoundCap (áp dụng cho kiểu nét vẽ đặc) và CustomCap (áp dụng cho mọi kiểu nét vẽ). Mặc định cho cả phần đầu và phần cuối: ButtCap.
Loại khớp: 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 đa giác, ngoại trừ đỉnh bắt đầu và đỉnh kết thúc. Hãy xem JointType để biết các loại mối liên kết được hỗ trợ. Giá trị mặc định là DEFAULT.
Mẫu nét vẽ: Solid (mặc định, được biểu thị bằng null) hoặc một chuỗi các đối tượng PatternItem sẽ được lặp lại. 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 dòng và độ dài dấu gạch ngang theo pixel) và Dot (hình tròn, căn giữa dòng, đường kính được xác định theo chiều rộng dòng theo pixel).
Chỉ mục Z: Thứ tự vẽ lớp phủ này so với các lớp phủ khác (bao gồm cả GroundOverlay, TileOverlay, Circle và Polygon nhưng không phải là 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 chỉ mục z là tuỳ ý. Chỉ số zIndex mặc định là 0.
Chế độ hiển thị: Cho biết hình nhiều đường hay có thể nhìn thấy hay không, tức là có được vẽ trên bản đồ hay không. 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 hình đa giác có được vẽ dưới dạng trắc địa hay không, 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 đ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 hình nhiều đường, 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.OnPolylineClickListener đã đăng ký qua setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).
Thẻ: Object liên kết với nhiều đường kẻ. Ví dụ: Object có thể chứa dữ liệu về nội dung mà nhiều dòng đại diện. Thao tác này dễ dàng hơn việc lưu trữ một Map<Polyline, 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.
Vùng: Xác định các span bằng các kiểu khác nhau dùng để kết xuất nhiều đường kẻ này. Bạn có thể sử dụng thuộc tính này để tạo nhiều đường với nhiều StrokeStyle trên các đoạn khác nhau của hình đa giác.

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 thin red line from London to New York.
 Polyline line = map.addPolyline(new PolylineOptions()
     .add(new LatLng(51.5, -0.1), new LatLng(40.7, -74.0))
     .width(5)
     .color(Color.RED));

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 `Polyline` này có tương đương với một kiểm thử khác hay không.
int	getColor() Lấy màu của hình nhiều đường này.
Giới hạn	getEndCap() Lấy giới hạn ở đỉnh cuối của đa giác này.
Chuỗi	getId() Lấy mã polyline này.
int	getJointType() Lấy loại khớp được sử dụng ở tất cả các đỉnh của hình đa giác, ngoại trừ đỉnh bắt đầu và đỉnh kết thúc.
List<PatternItem>	getPattern() Lấy mẫu nét vẽ của đa giác này.
List<LatLng>	getPoints() Trả về ảnh chụp nhanh của các đỉnh của đa đa này vào lúc này .
Giới hạn	getStartCap() Lấy giới hạn ở đỉnh bắt đầu của đa giác này.
Đối tượng	getTag() Lấy thẻ cho nhiều đa.
số thực dấu phẩy động	getWidth() Lấy chiều rộng của hình nhiều đường này.
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ị() Có được khả năng hiển thị của đa đường này.
void	remove() Xoá đa tuyến này 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	setColor(màu int) Đặt màu của đa giác này.
void	setEndCap(Cap endCap) Đặt nắp ở đỉnh cuối 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	setJointType(int joinType) Đặt loại khớp cho tất cả các đỉnh của hình đa giác, ngoại trừ đỉnh bắt đầu và đỉnh kết thúc.
void	setPattern(List<PatternItem> hoa văn) Đặt hoa văn nét gạch cho hình nhiều đường.
void	setPoints(List<LatLng> điểm) Đặt các điểm của đa giác này.
void	setSpans(Danh sách<StyleSpan> span) Đặt các span của polyline.
void	setStartCap(Cap startCap) Đặt giới hạn ở đỉnh bắt đầu 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 nhiều đường.
void	setWidth(chiều rộng nổi) Đặt chiều rộng của hình nhiều đường 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 Polyline 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 getColor ()

Lấy màu của hình nhiều đường này.

Trả về

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

công khai Cap getEndCap ()

Lấy giới hạn ở đỉnh cuối của đa giác này.

Trả về

loại hình tĩnh.

public Chuỗi getId ()

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

Trả về

mã nhận dạng nhiều đường liên kết này.

public int getJointType ()

Lấy loại khớp được sử dụng ở tất cả các đỉnh của hình đa giác, ngoại trừ đỉnh bắt đầu và đỉnh kết thúc. Hãy xem JointType để biết các giá trị có thể dùng.

Trả về

loại khớp.

public List<PatternItem> getPattern ()

Lấy mẫu nét vẽ của đa giác này.

Trả về

kiểu nét vẽ.

public List<LatLng> getPoints ()

Trả về ảnh chụp nhanh của các đỉnh của đa đa này vào lúc 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 nhiều đa dạng 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ẽ không được phản ánh qua nhiều đỉnh. Để thay đổi đỉnh, hãy gọi setPoints(List).

công khai Cap getStartCap ()

Lấy giới hạn ở đỉnh bắt đầu của đa giác này.

Trả về

giới hạn bắt đầu.

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

Lấy thẻ cho nhiều đa.

Trả về

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

công khai nổi getWidth ()

Lấy chiều rộng của hình nhiều đường này.

Trả về

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

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 nhiều đường liên kết có thể nhấp vào được, ứng dụng sẽ nhận được thông báo của GoogleMap.OnPolylineClickListener khi người dùng nhấp vào hình nhiều đường. Trình nghe sự kiện được đăng ký qua setOnPolylineClickListener(GoogleMap.OnPolylineClickListener).

Trả về

true nếu hình nhiều đường có thể nhấp vào; 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 ()

Có được khả năng hiển thị của đa đường này.

Trả về

chế độ hiển thị nhiều đường kẻ này.

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

Xoá đa tuyến này khỏi bản đồ. Sau khi loại bỏ nhiều polyline, hành vi của tất cả các phương thức polyline vẫn chưa được xác định.

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

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

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 setColor (int color)

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

Các tham số

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

public void setEndCap (Cap endCap)

Đặt nắp ở đỉnh cuối của đa giác này. Giới hạn mặc định là ButtCap.

Các tham số

Hình tĩnh	hình tĩnh. Không được là `null`.

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 setJointType (int joinType)

Đặt loại khớp cho tất cả các đỉnh của hình đa giác, ngoại trừ đỉnh bắt đầu và đỉnh kết thúc.

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	loại khớp.

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

Đặt hoa văn nét gạch cho hình nhiều đường. Mẫu nét vẽ mặc định là hình khối, được biểu thị bằng null.

Các tham số

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

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 setSpans (List<StyleSpan> span)

Đặt các span của polyline.

Các tham số

span

public void setStartCap (Cap startCap)

Đặt giới hạn ở đỉnh bắt đầu của đa giác này. Giới hạn bắt đầu mặc định là ButtCap.

Các tham số

CapCap	giới hạn bắt đầu. Không được là `null`.

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 tuỳ ý với đa giác này. Ví dụ: Object có thể chứa dữ liệu về nội dung mà nhiều dòng đại diện. Thao tác này dễ dàng hơn so với việc lưu trữ một Map<Polyline, 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 nhiều đường. Khi không hiển thị, nhiều đường kẻ không được vẽ nhưng vẫn giữ 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 setWidth (nổi chiều rộng)

Đặt chiều rộng của hình nhiều đường này.

Các tham số

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

public void setZIndex (float zIndex)

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

Các tham số

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