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 tròn

lớp cuối cùng công khai Vòng kết nối mở rộng Đối tượng

Một vòng tròn trên bề mặt trái đất (mũ hình cầu).

Hình tròn có các thuộc tính sau.

Trung phong: Tâm Hình tròn được chỉ định là LatLng.
Bán kính: Bán kính của hình tròn, tính bằng mét. Giá trị này phải bằng 0 hoặc lớn hơn.
Chiều rộng nét: Chiều rộng đường viền của vòng tròn tính bằng pixel trên 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: Màu đường viền hình tròn ở định dạng ARGB, giống định dạng mà Color sử dụng. Giá trị mặc định là màu đen (0xff000000).
Mẫu nét: Solid (mặc định, được biểu thị bằng null) hoặc một chuỗi đối tượng PatternItem cần lặp lại theo đường viền của vòng tròn. Các loại PatternItem có sẵn: Gap (được xác định theo độ dài nét vẽ tính bằng pixel), Dash (được xác định theo chiều rộng nét vẽ và độ dài dấu gạch ngang tính bằng pixel) và Dot (hình tròn, nằm ở giữa đường viền của hình tròn, đường kính được xác định bằng chiều rộng nét vẽ tính bằng pixel).
Màu nền: Màu của vòng tròn phải theo định dạng ARGB, định dạng mà Color sử dụng. Giá trị mặc định là trong suốt (0x00000000).
Chỉ mục Z: Thứ tự vẽ lớp phủ ô này tương ứng với các lớp phủ khác (bao gồm GroundOverlay, TileOverlay, Polyline và Polygon 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ó chỉ mục z nhỏ hơn. 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 vòng tròn hiện lên hay vô hình, tức là vòng tròn đó được vẽ trên bản đồ. Vòng tròn ẩn sẽ không được vẽ, nhưng giữ lại tất cả các thuộc tính khác. Giá trị mặc định là true, tức là hiển thị.
Gắn thẻ: Một Object liên kết với vòng kết nối. Ví dụ: Object có thể chứa dữ liệu về nội dung mà vòng tròn đại diện. Việc này sẽ dễ dàng hơn so với việc lưu trữ một Map<Circle, Object> riêng. Mộ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ã nhận dạng trong 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 trong thời gian chạy.

Ví dụ:

GoogleMap map;
 // ... get a map.
 // Add a circle in Sydney
 Circle circle = map.addCircle(new CircleOptions()
     .center(new LatLng(-33.87365, 151.20689))
     .radius(10000)
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));

Xin lưu ý rằng trình kết xuất bản đồ hiện tại không thể vẽ vòng tròn nếu vòng tròn bao gồm cực Bắc hoặc cực Nam. Tuy nhiên, đường viền vẫn sẽ được vẽ chính xác.

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

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

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

LatLng	getCenter() Trả về tâm dưới dạng `LatLng`.
int	getFillColor() Trả về màu nền của Vòng tròn này.
Chuỗi	getId() Lấy mã nhận dạng của vòng kết nối này.
gấp đôi	Hàm getRadius() Trả về bán kính của hình tròn, tính bằng mét.
int	Hàm getStrokeColor() Trả về màu của nét vẽ.
List<PatternItem>	getStrokePattern() Trả về mẫu nét của đường viền của đường tròn này.
float	Hàm getStrokeWidth() Trả về chiều rộng của nét vẽ.
Đối tượng	Hàm getTag() Lấy thẻ cho vòng kết nối.
float	getZIndex() Trả về zIndex.
boolean	isClickable() Xem khả năng nhấp vào được vòng tròn.
boolean	isVisible() Kiểm tra xem vòng kết nối có hiển thị hay không.
void	xoá() Xóa vòng tròn này khỏi bản đồ.
void	setCenter(trung tâm LatLng) Đặt tâm bằng cách sử dụng `LatLng`.
void	setClickable(có thể nhấp vào boolean) Đặt khả năng nhấp vào vòng tròn.
void	setFillColor(màu int) Đặt màu nền.
void	setRadius(bán kính gấp đôi) Đặt bán kính tính bằng mét.
void	setStrokeColor(màu int) Đặt màu cho nét vẽ.
void	setStrokePattern(Danh sách<PatternItem> mẫu) Đặt mẫu nét cho đường viền của hình tròn.
void	setStrokeWidth(độ rộng số thực) Đặt chiều rộng nét vẽ.
void	setTag(Thẻ đối tượng) Đặt thẻ cho vòng kết nối.
void	setVisible(boolean hiển thị) Đặt chế độ hiển thị của vòng kết nối.
void	setZIndex(số thực dấu phẩy động zIndex) Thiết lập zIndex.

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

Trong lớp java.lang.Object

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

Phương thức công khai

công khai LatLng getCenter ()

Trả về tâm dưới dạng LatLng.

Trả bóng

Trung tâm địa lý dưới dạng LatLng.

public int getFillColor ()

Trả về màu nền của Vòng tròn này.

Trả bóng

Màu nền của hình tròn ở định dạng ARGB.

công khai Chuỗi getId ()

Lấy mã nhận dạng của vòng kết nối này. Id sẽ là duy nhất trong số tất cả các Vòng kết nối trên bản đồ.

công khai gấp đôi getRadius ()

Trả về bán kính của hình tròn, tính bằng mét.

Trả bóng

Bán kính tính bằng mét.

public int getStrokeColor ()

Trả về màu của nét vẽ.

Trả bóng

Màu của vòng tròn ở định dạng ARGB.

công khai Danh sách<PatternItem> getStrokePattern ()

Trả về mẫu nét của đường viền của đường tròn này.

Trả bóng

mẫu nét vẽ.

public float getStrokeWidth ()

Trả về chiều rộng của nét vẽ.

Trả bóng

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

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

Lấy thẻ cho vòng kết nối.

Trả bóng

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

public float getZIndex ()

Trả về zIndex.

Trả bóng

zIndex của vòng kết nối này.

công khai boolean isClickable ()

Xem khả năng nhấp vào được vòng tròn. Nếu người dùng nhấp vào được vòng tròn đó, ứng dụng sẽ nhận được thông báo gửi đến GoogleMap.OnCircleClickListener khi người dùng nhấp vào vòng tròn đó. Trình nghe sự kiện được đăng ký thông qua setOnCircleClickListener(GoogleMap.OnCircleClickListener).

Trả bóng

true nếu vòng tròn có thể nhấp vào; false nếu không thể nhấp vào.

boolean công khai isVisible ()

Kiểm tra xem vòng kết nối có hiển thị hay không.

Trả bóng

true nếu vòng tròn hiển thị; false nếu vòng tròn đó không hiển thị.

công khai khoảng trống xoá ()

Xóa vòng tròn này khỏi bản đồ. Sau khi một vòng kết nối bị xoá, hành vi của tất cả các phương thức của vòng kết nối đó không thể xác định.

công khai khoảng trống setCenter (trung tâm LatLng)

Đặt tâm bằng cách sử dụng LatLng.

Tâm không được rỗng, vì không có giá trị mặc định.

Các tham số

giữa	Tâm địa lý của vòng tròn, được chỉ định dưới dạng `LatLng`.

Gửi

NullPointerException	nếu điểm giữa là rỗng

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

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

Các tham số

có thể nhấp	Cài đặt khả năng nhấp mới cho vòng kết nối.

public void setFillColor (int color)

Đặt màu nền.

Màu nền là màu bên trong hình tròn, ở định dạng số nguyên do Color chỉ định. Nếu bạn sử dụng TRANSPARENT thì sẽ không vẽ màu nền.

Các tham số

màu	Màu ở định dạng `Color`.

công khai khoảng trống setRadius (bán kính gấp đôi)

Đặt bán kính tính bằng mét.

Bán kính phải bằng 0 hoặc lớn hơn.

Các tham số

bán kính	Bán kính tính bằng mét.

Gửi

IllegalArgumentException	nếu bán kính là số âm

public void setStrokeColor (int color)

Đặt màu cho nét vẽ.

Màu nét vẽ là màu cho đường viền của vòng tròn này, ở định dạng số nguyên do Color chỉ định. Nếu bạn sử dụng TRANSPARENT thì sẽ không có đường viền nào được vẽ.

Các tham số

màu	Màu nét vẽ ở định dạng `Color`.

công khai khoảng trống setStrokePattern (List<PatternItem>pattern)

Đặt mẫu nét cho đường viền của hình tròn. Mẫu nét mặc định là kiểu liền nét, được biểu thị bằng null.

Các tham số

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

công khai khoảng trống setStrokeWidth (độ rộng số thực)

Đặt chiều rộng nét vẽ.

Độ rộng nét vẽ là độ rộng (tính bằng pixel trên màn hình) của đường viền hình tròn. Giá trị này phải bằng 0 hoặc lớn hơn. Nếu số này bằng 0 thì sẽ không có đường viền nào được vẽ. Giá trị mặc định là 10.

Các tham số

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

Gửi

IllegalArgumentException	nếu chiều rộng là số âm

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

Đặt thẻ cho vòng kết nối.

Bạn có thể sử dụng thuộc tính này để liên kết một Object tuỳ ý với vòng kết nối này. Ví dụ: Object có thể chứa dữ liệu về nội dung mà vòng tròn đại diện. Việc này sẽ dễ dàng hơn so với việc lưu trữ một Map<Circle, Object> riêng. Mộ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ã trong 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ữa, nhằm ngăn ngừa rò rỉ bộ nhớ trong ứng dụng của bạn.

Các tham số

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

public void setVisible (boolean visible)

Đặt chế độ hiển thị của vòng kết nối.

Nếu vòng tròn này không hiển thị thì nó sẽ không được vẽ. Tất cả trạng thái khác đều được giữ nguyên. Các vòng kết nối sẽ hiển thị theo mặc định.

Các tham số

hiển thị	`true` để ẩn vòng kết nối này; `false` để ẩn vòng kết nối này.

công khai khoảng trống setZIndex (float zIndex)

Thiết lập zIndex.

Lớp phủ (chẳng hạn như vòng tròn) có zIndice cao hơn được vẽ phía trên các lớp phủ có chỉ số thấp hơn.

Các tham số

zIndex	Giá trị zIndex.