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

Hình tròn

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

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

Vòng tròn có các thuộc tính sau.

Center: Tâm của Vòng tròn là một LatLng.
Bán kính: Bán kính của hình tròn, được chỉ đị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 vẽ: Chiều rộng của vòng tròn đại diện cho 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 vẽ: Màu của đường viền vòng tròn ở định dạng ARGB, cùng định dạng được Color sử dụng. Giá trị mặc định là màu đen (0xff000000).
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 vòng tròn. 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 của vòng tròn, đường kính được xác định theo chiều rộng nét vẽ theo pixel).
Tô màu: Màu của vòng tròn lấp đầy ở định dạng ARGB, cùng định dạng mà Color sử dụng. Giá trị mặc định là minh bạch (0x00000000).
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, Polyline 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 vòng kết nối có hiển thị hay không, tức là có vẽ vòng tròn trên bản đồ hay không. Một vòng tròn ẩn không được vẽ nhưng vẫn giữ lại tất cả thuộc tính khác. Giá trị mặc định là true, tức là hiển thị.
Thẻ: Object được liên kết với vòng kết nối. Ví dụ, Object có thể chứa dữ liệu về những gì vòng kết nối đại diện. Thao tác này dễ dàng hơn việc lưu trữ một Map<Circle, 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 circle in Sydney
 Circle circle = map.addCircle(new CircleOptions()
     .center(new LatLng(-33.87365, 151.20689))
     .radius(10000)
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));

Lưu ý rằng trình kết xuất bản đồ hiện tại không thể vẽ hình tròn màu tô nếu hình tròn bao gồm cực Bắc hoặc cực Nam. Tuy nhiên, bố cục sẽ vẫn đượ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 dành cho nhà phát triển về Hình dạng.

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

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

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

công khai LatLng getCenter ()

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

Trả về

Trung tâm địa lý là một LatLng.

public int getFillColor ()

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

Trả về

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

public Chuỗi getId ()

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

public double getRadius ()

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

Trả về

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

public int getStrokeColor ()

Trả về màu nét gạch.

Trả về

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

public List<PatternItem> getStrokePattern ()

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

Trả về

kiểu nét vẽ.

công khai nổi getStrokeWidth ()

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

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 vòng kết nối.

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 ()

Trả về zIndex.

Trả về

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

boolean công khai isClickable ()

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

Trả về

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

boolean công khai isVisible ()

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

Trả về

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 xóa ()

Xoá vòng kết nối này khỏi bản đồ. Sau khi xóa một vòng kết nối, hành vi của tất cả các phương thức của vòng kết nối đều chưa được xác định.

public void setCenter (Trung tâm LatLng)

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

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

Các tham số

giữa	Trung tâm địa lý của vòng tròn, được chỉ định là một `LatLng`.

Gửi

NullPointerException	nếu giá trị rỗng ở giữa

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

Đặt khả năng nhấp của vòng tròn. Nếu có thể nhấp vào vòng tròn đó, ứng dụng của bạn sẽ nhận được thông báo của GoogleMap.OnCircleClickListener khi người dùng nhấp vào vòng tròn đó. Trình nghe sự kiện được đăng ký 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 (màu sắc)

Đặt màu tô.

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

Các tham số

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

public void setRadius (gấp đôi bán kính)

Đặt bán kính theo 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

Mục ngoại lệ không hợp lệ	nếu bán kính âm

public void setStrokeColor (int color)

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

Màu nét vẽ là màu của đường viền vòng tròn này, ở định dạng số nguyên do Color chỉ định. Nếu sử dụng TRANSPARENT thì 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`.

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

Đặt mẫu nét vẽ của đường viền vòng tròn. 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.

Chiều rộng nét vẽ là chiều rộng (tính bằng pixel màn hình) của đường viền vòng tròn. Giá trị này phải bằng 0 hoặc lớn hơn. Nếu số 0 thì không 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 màn hình.

Gửi

Mục ngoại lệ không hợp lệ	nếu chiều rộng âm

public void 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 Object tùy ý với vòng kết nối này. Ví dụ, Object có thể chứa dữ liệu về những gì vòng kết nối đại diện. Thao tác này dễ dàng hơn so với việc lưu trữ một Map<Circle, 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 vòng kết nối.

Nếu vòng tròn này không hiển thị thì vòng tròn này sẽ không được vẽ. Tất cả các trạng thái khác vẫn đượ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` để hiển thị vòng kết nối này; `false` để ẩn vòng kết nối.

public void setZIndex (float zIndex)

Đặt zIndex.

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

Các tham số

Chỉ mục zIndex	Giá trị zIndex.