Vòng tròn

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

Hình tròn trên bề mặt trái đất (nắp hình cầu).

Hình tròn có các tính chất sau.

Giữa
Tâm tâm của Vòng tròn được chỉ định là 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 từ 0 trở lên.
Độ rộng nét chữ
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à độc lập về mức thu phóng của máy ảnh. Giá trị mặc định là 10.
Màu nét chữ
Màu của đường viền vòng tròn ở định dạng ARGB, cùng định dạng mà Color sử dụng. Giá trị mặc định là màu đen (0xff000000).
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 của vòng tròn. Hiện có PatternItem loại: 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ài gạch ngang trong pixel) và Dot (hình tròn, chính giữa trên đường viền của đường 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 sẽ được tô bằng định dạng ARGB, cùng định dạng mà Color sử dụng. Giá trị mặc định là trong suốt (0x00000000).
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, Polyline và Polygon nhưng chứ không phải 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 vòng tròn có thể nhìn thấy được hay không nhìn thấy được, tức là vòng tròn đó có được vẽ trên bản đồ hay không. Một vòng tròn 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ị.
Thẻ
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. Cách này dễ hơn so với 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ã 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 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ẽ vòng tròn lấp đầy nếu bao gồm cả cực Bắc hoặc cực Nam. Tuy nhiên, đường viền 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 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

LatLng
getCenter()
Trả về trung tâm dưới dạng LatLng.
int
getFillColor()
Trả về màu nền của Hình 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
getRadius()
Trả về bán kính của vòng tròn, tính bằng mét.
int
getStrokeColor()
Trả về màu nét vẽ.
Liệt kê<PatternItem>
getStrokePattern()
Trả về mẫu nét vẽ của đường viền vòng tròn.
số thực dấu phẩy động
getStrokeWidth()
Trả về chiều rộng của 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()
Xem khả năng nhấp của vòng kết nối.
boolean
isVisible()
Kiểm tra xem vòng tròn có hiển thị không.
void
remove()
Xóa vòng tròn 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(boolean có thể nhấp)
Đặt khả năng nhấp của vòng kết nối.
void
setFillColor(màu int)
Đặt màu nền.
void
setRadius(bán kính gấp đôi)
Đặt bán kính theo mét.
void
setStrokeColor(màu int)
Đặt màu nét vẽ.
void
setStrokePattern(Mẫu List<PatternItem>)
Đặt mẫu nét vẽ của đường viền vòng tròn.
void
setStrokeWidth(chiều rộng độ chính xác đơn)
Đặ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 visible)
Đặt chế độ hiển thị của vòng kết nối.
void
setZIndex(nổi zIndex)
Đặt zIndex.

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

Phương thức công khai

công khai LatLng getCenter ()

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

Giá trị trả về
  • Trung tâm địa lý dưới dạng LatLng.

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

Trả về màu nền của Hình tròn này.

Giá trị trả về
  • Màu nền của vòng tròn ở định dạng ARGB.

công khai Chuỗi văn bản 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 vòng tròn, tính bằng mét.

Giá trị trả về
  • Bán kính tính bằng mét.

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

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

Giá trị trả về
  • Màu của vòng tròn ở định dạng ARGB.

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

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

Giá trị trả về
  • kiểu nét vẽ.

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

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

Giá trị trả về
  • 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.

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

Trả về zIndex.

Giá trị trả về
  • zIndex của vòng kết nối này.

công khai boolean isClickable ()

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

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

công khai boolean isVisible ()

Kiểm tra xem vòng tròn có hiển thị không.

Giá trị trả về
  • true nếu vòng tròn hiển thị; false nếu phương diện này không xuất hiện.

công khai trống xoá ()

Xóa vòng tròn 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 vòng kết nối chưa được xác định.

công khai trống setCenter (LatLng)

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

Không được để trống căn giữa vì không có giá trị mặc định.

Tham số
giữa Tâm địa lý của vòng tròn, được chỉ định là LatLng.
Gửi
NullPointerException nếu tâm rỗng

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

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

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

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

Đặt màu nền.

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

Tham số
màu Màu ở định dạng Color.

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

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

Bán kính phải từ 0 trở lên.

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

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

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

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

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

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

Đặt mẫu nét vẽ của đường viền vòng tròn. 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 setStrokeWidth (chiều rộng của số thực dấu phẩy động)

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

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

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 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 Object tùy ý với vòng kết nối này. Cho Chẳng hạn như Object có thể chứa dữ liệu về nội dung mà vòng tròn biểu thị. Cách này dễ hơn so với 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ã 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 vòng kết nối.

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

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

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

Đặt zIndex.

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

Tham số
zIndex Giá trị zIndex.