Kiểu bản đồ mới sắp xuất hiện trên Nền tảng Google Maps. Bản cập nhật này để tạo kiểu bản đồ bao gồm một bảng màu mặc định mới và các cải tiến về trải nghiệm bản đồ cũng như khả năng hữu dụng. Tất cả kiểu bản đồ sẽ được cập nhật tự động vào tháng 3 năm 2025. Để biết thêm thông tin về phạm vi cung cấp và cách chọn tham gia sớm hơn, hãy xem bài viết Kiểu bản đồ mới cho Nền tảng Google Maps.

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

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

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

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 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 tài liệu dành cho nhà phát triển Hình dạng của chúng tôi.

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

boolean	bằng(Đối tượng khác) Kiểm thử xem `Polyline` này có bằng một mã 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 hình nhiều đường này.
Chuỗi	getId() Lấy mã nhận dạng của hình nhiều đường này.
int	getJointType() Lấy kiểu khớp dùng ở tất cả các đỉnh của hình nhiều đường, ngoại trừ đỉnh bắt đầu và kết thúc.
Liệt kê<PatternItem>	getPattern() Lấy mẫu nét vẽ của hình nhiều đường này.
Danh sách<LatLng>	getPoints() Trả về ảnh chụp nhanh các đỉnh của hình nhiều đường này tại thời điểm này .
Giới hạn	getStartCap() Lấy giới hạn ở đỉnh bắt đầu của hình nhiều đường này.
Đối tượng	getTag() Lấy thẻ cho hình nhiều đường.
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 hình nhiều đường này.
int	hashCode()
boolean	isClickable() Xem khả năng nhấp của hình nhiều đường.
boolean	isGeodesic() Kiểm tra xem mỗi đoạn của đường có được vẽ dưới dạng trắc địa hay không.
boolean	isVisible() Xem mức độ hiển thị của hình nhiều đường này.
void	remove() Xoá hình nhiều đường này khỏi bản đồ.
void	setClickable(boolean có thể nhấp) Đặt khả năng nhấp của hình nhiều đường.
void	setColor(màu int) Đặt màu cho hình nhiều đường này.
void	setEndCap(Cap endCap) Đặt giới hạn ở đỉnh cuối của hình nhiều đường này.
void	setGeodesic(boolean geodesic) Đặt xem có vẽ từng đoạn của đường dưới dạng trắc địa hay không.
void	setJointType(int chungType) Đặt kiểu khớp cho tất cả các đỉnh của hình nhiều đường, ngoại trừ đỉnh bắt đầu và kết thúc.
void	setPattern(Mẫu List<PatternItem>) Đặt mẫu nét vẽ của hình nhiều đường.
void	setPoints(Danh sách<LatLng> điểm) Đặt các điểm của hình nhiều đường này.
void	setSpans(List<StyleSpan> span) Đặt các khoảng (span) của hình nhiều đường.
void	setStartCap(Cap startCap) Đặt giới hạn tại đỉnh bắt đầu của hình nhiều đường này.
void	setTag(Thẻ đối tượng) Đặt thẻ cho hình nhiều đường.
void	setVisible(boolean visible) Đặt chế độ hiển thị của hình nhiều đường này.
void	setWidth(chiều rộng số thực) Đặt chiều rộng của hình nhiều đường này.
void	setZIndex(nổi zIndex) Đặt zIndex của hình nhiều đường này.

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

Của lớp học java.lang.Object

boolean	bằng(Đối tượng arg0)
cuối cùng Lớp<?>	getClass()
int	hashCode()
cuối cùng trống	notify()
cuối cùng trống	notifyAll()
Chuỗi	toString()
cuối cùng trống	chờ(long arg0, int arg1)
cuối cùng trống	chờ(long arg0)
cuối cùng trống	wait()

Phương thức công khai

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

Kiểm thử xem Polyline 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 đánh chặn getColor ()

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

Giá trị trả về

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

công khai Giới hạn getEndCap ()

Lấy giới hạn ở đỉnh cuối của hình nhiều đường này.

Giá trị trả về

loại hình tĩnh.

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

Lấy mã nhận dạng của hình nhiều đường này. Mã này phải là duy nhất trong số tất cả hình nhiều đường trên bản đồ.

Giá trị trả về

mã nhận dạng của hình nhiều đường này.

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

Lấy kiểu khớp dùng ở tất cả các đỉnh của hình nhiều đường, ngoại trừ đỉnh bắt đầu và kết thúc. Xem JointType để biết các giá trị có thể có.

Giá trị trả về

loại khớp.

công khai Liệt kê<PatternItem> getPattern ()

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

Giá trị trả về

kiểu nét vẽ.

công khai Danh sách<LatLng> getPoints ()

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

công khai Giới hạn getStartCap ()

Lấy giới hạn ở đỉnh bắt đầu của hình nhiều đường này.

Giá trị trả về

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

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

Lấy thẻ cho hình nhiều đường.

Giá trị trả về

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

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

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

Giá trị trả về

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

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

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

Giá trị trả về

zIndex của hình nhiều đường.

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

công khai boolean isClickable ()

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

Giá trị trả về

true nếu hình nhiều đường có thể nhấp vào được; nếu không, sẽ trả về false.

công khai boolean isGeodesic ()

Kiểm tra xem mỗi đoạn của đường có được vẽ dưới dạng trắc địa hay không.

Giá trị trả về

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

công khai boolean isVisible ()

Xem mức độ hiển thị của hình nhiều đường này.

Giá trị trả về

mức độ hiển thị của hình nhiều đường này.

công khai trống xoá ()

Xoá hình nhiều đường này khỏi bản đồ. Sau khi một hình nhiều đường đã bị xoá, hoạt động của tất cả hình chưa được xác định.

công khai trống setClickable (boolean có thể nhấp)

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

Tham số

có thể nhấp	Chế độ cài đặt mới về khả năng nhấp cho hình nhiều đường.

công khai trống setColor (int color)

Đặt màu cho hình nhiều đường này.

Tham số

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

công khai trống setEndCap (Cap endCap)

Đặt giới hạn ở đỉnh cuối của hình nhiều đường này. Giới hạn mặc định là ButtCap.

Tham số

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

công khai trống setGeodesic (boolean trắc địa)

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

Tham số

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

công khai trống setJointType (int joinType)

Đặt kiểu khớp cho tất cả các đỉnh của hình nhiều đường, ngoại trừ đỉnh bắt đầu và 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 kết nối không xác định hoặc không phải là một trong các giá trị được cho phép.

Tham số

jointType	loại khớp.

công khai trống setPattern (Mẫu List<PatternItem>)

Đặt mẫu nét vẽ của hình nhiều đường. Mẫu nét vẽ mặc định là nét đậm, được biểu thị bằng null.

Tham số

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

công khai trống setPoints (Liệt kê<LatLng> điểm)

Đặt các điểm của hình nhiều đường này. Phương thức này sẽ lấy một bản sao của các điểm, để các đột biến đối với points sẽ không ảnh hưởng đến hình nhiều đường này.

Tham số

điểm	danh sách các `LatLng` là đỉnh của hình nhiều đường.

công khai trống setSpans (List<StyleSpan> span)

Đặt các khoảng (span) của hình nhiều đường.

Tham số

span

công khai trống setStartCap (Cap startCap)

Đặt giới hạn tại đỉnh bắt đầu của hình nhiều đường này. Giới hạn bắt đầu mặc định là ButtCap.

Tham số

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

công khai trống setTag (Thẻ đối tượng)

Đặt thẻ cho hình nhiều đường.

Bạn có thể sử dụng thuộc tính này để liên kết một Object tuỳ ý với hình nhiều đường này. Để ví dụ: Object có thể chứa dữ liệu về nội dung hình nhiều đường đại diện. Cách này dễ hơn so với 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ã String tương ứng với mã nhận dạng của một tập dữ liệu. SDK Google Maps dành cho Android cũng không được đọc và 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ữa để ngăn chặn rò rỉ bộ nhớ trong ứng dụng của bạn.

Tham số

thẻ	nếu rỗng, thẻ sẽ bị xoá.

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

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

Tham số

hiển thị	nếu `true`, thì hình nhiều đường sẽ hiển thị; nếu là `false` thì sẽ không phải như vậy.

công khai trống setWidth (chiều rộng của số thực dấu phẩy động)

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

Tham số

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

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

Đặt zIndex của hình nhiều đường này. Hình nhiều đường có zIndice cao hơn được vẽ phía trên những đường có zIndice chỉ mục phía dưới.

Tham số

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