วงกลม

คลาสสุดท้ายสาธารณะ Circle ขยายออบเจ็กต์

วงกลมบนพื้นผิวโลก (หมวกทรงกลม)

วงกลมมีคุณสมบัติดังต่อไปนี้

เซ็นเตอร์
ระบุจุดศูนย์กลางของวงกลมเป็น LatLng
รัศมี
รัศมีของวงกลม ระบุเป็นเมตร ซึ่งควรเท่ากับ 0 ขึ้นไป
ความกว้างของเส้นโครงร่าง
ความกว้างของเส้นขอบของวงกลมในหน่วยพิกเซลหน้าจอ ความกว้างจะคงที่และไม่ขึ้นอยู่กับระดับการซูมของกล้อง ค่าเริ่มต้นคือ 10
สีเส้นโครงร่าง
สีของเส้นขอบวงกลมในรูปแบบ ARGB ซึ่งเป็นรูปแบบเดียวกับที่ Color ใช้ ค่าเริ่มต้นคือสีดำ (0xff000000)
รูปแบบเส้น
ทึบ (ค่าเริ่มต้นแสดงด้วย null) หรือลำดับของวัตถุ PatternItem ที่จะแสดงซ้ำในโครงร่างของวงกลม ประเภท PatternItem ที่ใช้ได้: Gap (ระบุด้วยความยาวช่องว่างเป็นพิกเซล), Dash (กำหนดโดยความกว้างของเส้นโครงร่างและความยาวเส้นประเป็นพิกเซล) และ Dot (เป็นวงกลม ตรงกลางของเส้นรอบวงของวงกลม เส้นผ่านศูนย์กลางที่กำหนดโดยความกว้างของเส้นโครงร่างเป็นพิกเซล)
เติมสี
สีของวงกลมจะเติมรูปแบบ ARGB ซึ่งเป็นรูปแบบเดียวกับที่ Color ใช้ ค่าเริ่มต้นคือโปร่งใส (0x00000000)
ดัชนีลำดับ Z
ลำดับการวาดการวางซ้อนของชิ้นส่วนนี้โดยสัมพันธ์กับการวางซ้อนอื่นๆ (รวมถึง GroundOverlay, TileOverlay, Polyline และ Polygon แต่ไม่รวม Marker) การวางซ้อนที่มีดัชนี z ใหญ่กว่าจะถูกวาดทับบนโฆษณาซ้อนทับที่มีดัชนี z ที่เล็กกว่า ลำดับของโฆษณาซ้อนทับที่มีดัชนีลำดับ Z เดียวกันจะเป็นแบบอิสระ zIndex เริ่มต้นคือ 0
ระดับการแชร์
ระบุว่าวงกลมนั้นมองเห็นหรือมองไม่เห็น เช่น วาดบนแผนที่หรือไม่ ระบบจะไม่วาดวงกลมที่มองไม่เห็น แต่องค์ประกอบอื่นๆ ทั้งหมดของวงกลมนั้นจะยังคงอยู่ ค่าเริ่มต้นคือ true นั่นคือแสดง
ติดแท็ก
Object ที่เชื่อมโยงกับแวดวง ตัวอย่างเช่น Object อาจมีข้อมูลเกี่ยวกับสิ่งที่วงกลมนั้นเป็นตัวแทน วิธีนี้ง่ายกว่าการเก็บ Map<Circle, Object> แยกต่างหาก อีกตัวอย่างหนึ่งก็คือ คุณสามารถเชื่อมโยงรหัส String ที่ตรงกับรหัสจากชุดข้อมูล Google Maps SDK สำหรับ Android จะไม่อ่านและเขียนพร็อพเพอร์ตี้นี้

ต้องเรียกใช้เมธอดในคลาสนี้บนเธรด UI ของ Android หากไม่เป็นเช่นนั้น จะมีการส่ง IllegalStateException ขณะรันไทม์

ตัวอย่าง

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

โปรดทราบว่าตัวแสดงผลแผนที่ปัจจุบันไม่สามารถวาดพื้นที่เป็นวงกลมได้ หากวงกลมครอบคลุมทั้งขั้วโลกเหนือหรือขั้วใต้ อย่างไรก็ตาม ระบบจะยังวาดโครงร่างได้อย่างถูกต้อง

คู่มือนักพัฒนา

โปรดอ่านคู่มือนักพัฒนาซอฟต์แวร์เกี่ยวกับรูปร่างเพื่อดูข้อมูลเพิ่มเติม

สรุปวิธีการสาธารณะ

LatLng
getCenter()
แสดงจุดศูนย์กลางเป็น LatLng
int
getFillColor()
แสดงสีเติมของวงกลมนี้
สตริง
getId()
รับรหัสของแวดวงนี้
คู่
getRadius()
แสดงรัศมีของวงกลมเป็นเมตร
int
getStrokeColor()
แสดงสีของเส้นโครงร่าง
List<PatternItem>
getStrokePattern()
แสดงรูปแบบเส้นโครงร่างของโครงร่างวงกลมนี้
float
getStrokeWidth()
แสดงความกว้างของเส้นโครงร่าง
ออบเจ็กต์
getTag()
รับแท็กสำหรับแวดวงนี้
float
getZIndex()
แสดง zIndex
boolean
isClickable()
รับความสามารถในการคลิกของแวดวง
boolean
isVisible()
ตรวจสอบว่าวงกลมดังกล่าวมองเห็นหรือไม่
void
remove()
นำวงกลมนี้ออกจากแผนที่
void
setCenter(LatLng center)
ตั้งค่าศูนย์กลางโดยใช้ LatLng
void
setClickable(บูลีนที่คลิกได้)
ตั้งค่าความสามารถในการคลิกของวงกลม
void
setFillColor(สี int)
ตั้งค่าสีเติม
void
setRadius(รัศมีคู่)
กำหนดรัศมีเป็นเมตร
void
setStrokeColor(สี)
ตั้งค่าสีของเส้น
void
setStrokePattern(List<PatternItem>)
ตั้งค่ารูปแบบเส้นโครงร่างของโครงร่างของวงกลม
void
setStrokeWidth(ความกว้างแบบลอย)
ตั้งค่าความกว้างของเส้นโครงร่าง
void
setTag(แท็กออบเจ็กต์)
ตั้งค่าแท็กสำหรับแวดวง
void
setVisible(แสดงบูลีน)
ตั้งค่าการเปิดเผยของแวดวง
void
setZIndex(Float zIndex)
ตั้งค่า zIndex

ข้อมูลสรุปของเมธอดที่รับช่วงมา

วิธีการสาธารณะ

สาธารณะ LatLng getCenter ()

แสดงจุดศูนย์กลางเป็น LatLng

คิกรีเทิร์น
  • ศูนย์กลางทางภูมิศาสตร์ในฐานะ LatLng

สาธารณะ int getFillColor ()

แสดงสีเติมของวงกลมนี้

คิกรีเทิร์น
  • สีเติมของวงกลมในรูปแบบ ARGB

สาธารณะ สตริง getId ()

รับรหัสของแวดวงนี้ ID จะไม่ซ้ำกับแวดวงทั้งหมดบนแผนที่

สาธารณะ คู่ getRadius ()

แสดงรัศมีของวงกลมเป็นเมตร

คิกรีเทิร์น
  • รัศมีเป็นเมตร

สาธารณะ int getStrokeColor ()

แสดงสีของเส้นโครงร่าง

คิกรีเทิร์น
  • สีของวงกลมในรูปแบบ ARGB

สาธารณะ รายการ<PatternItem> getStrokePattern ()

แสดงรูปแบบเส้นโครงร่างของโครงร่างวงกลมนี้

คิกรีเทิร์น
  • ของเส้นโครงร่าง

ลอย สาธารณะ getStrokeWidth ()

แสดงความกว้างของเส้นโครงร่าง

คิกรีเทิร์น
  • ความกว้างเป็นพิกเซลหน้าจอ

ออบเจ็กต์สาธารณะ getTag ()

รับแท็กสำหรับแวดวงนี้

คิกรีเทิร์น
  • แท็กหากมีการตั้งค่าด้วย setTag หรือ null หากไม่มีการตั้งค่าแท็ก

ทศนิยมสาธารณะ getZIndex ()

แสดง zIndex

คิกรีเทิร์น
  • zIndex ของแวดวงนี้

บูลีนสาธารณะ isClickable ()

รับความสามารถในการคลิกของแวดวง หากวงกลมนั้นคลิกได้ แอปจะได้รับการแจ้งเตือนไปยัง GoogleMap.OnCircleClickListener เมื่อผู้ใช้คลิกวงกลม Listener เหตุการณ์ได้รับการลงทะเบียนจนถึงวันที่ setOnCircleClickListener(GoogleMap.OnCircleClickListener)

คิกรีเทิร์น
  • true หากวงกลมสามารถคลิกได้ หรือ false หากไม่สามารถคลิกได้

บูลีนสาธารณะ isVisible ()

ตรวจสอบว่าวงกลมดังกล่าวมองเห็นหรือไม่

คิกรีเทิร์น
  • true ถ้าวงกลมนั้นมองเห็นได้ falseถ้ามองไม่เห็น

โมฆะสาธารณะ นำออก ()

นำวงกลมนี้ออกจากแผนที่ หลังจากที่นำแวดวงออกแล้ว จะไม่มีการกำหนดลักษณะการทำงานของเมธอดทั้งหมด

สาธารณะ โมฆะ setCenter (LatLng center)

ตั้งค่าศูนย์กลางโดยใช้ LatLng

จุดศูนย์กลางต้องไม่เป็นค่าว่าง เนื่องจากไม่มีค่าเริ่มต้น

พารามิเตอร์
ตรงกลาง ศูนย์กลางทางภูมิศาสตร์ของวงกลม ระบุเป็น LatLng
การขว้าง
NullPointerException หากกึ่งกลางเป็นค่าว่าง

โมฆะสาธารณะ setClickable (บูลีนที่คลิกได้)

ตั้งค่าความสามารถในการคลิกของวงกลม หากวงกลมนั้นคลิกได้ แอปจะได้รับการแจ้งเตือนไปยัง GoogleMap.OnCircleClickListener เมื่อผู้ใช้คลิกวงกลม Listener เหตุการณ์ได้รับการลงทะเบียนจนถึงวันที่ setOnCircleClickListener(GoogleMap.OnCircleClickListener)

พารามิเตอร์
คลิกได้ การตั้งค่าความสามารถในการคลิกได้ใหม่สำหรับแวดวง

โมฆะสาธารณะ setFillColor (สี int)

ตั้งค่าสีเติม

สีเติมคือสีภายในวงกลมในรูปแบบจำนวนเต็มที่ระบุโดย Color หากใช้ TRANSPARENT จะไม่มีการเติมสี

พารามิเตอร์
สี สีในรูปแบบ Color

โมฆะสาธารณะ setRadius (รัศมีสองเท่า)

กำหนดรัศมีเป็นเมตร

รัศมีต้องเป็น 0 หรือมากกว่า

พารามิเตอร์
รัศมี รัศมี หน่วยเป็นเมตร
การขว้าง
IllegalArgumentException ถ้ารัศมีเป็นค่าลบ

โมฆะสาธารณะ setStrokeColor (สีแต้ม)

ตั้งค่าสีของเส้น

สีเส้นโครงร่างคือสีโครงร่างของวงกลมนี้ในรูปแบบจำนวนเต็มที่ระบุโดย Color หากใช้ TRANSPARENT จะไม่มีการวาดโครงร่าง

พารามิเตอร์
สี สีเส้นโครงร่างในรูปแบบ Color

สาธารณะ void setStrokePattern (รูปแบบรายการ<PatternItem>)

ตั้งค่ารูปแบบเส้นโครงร่างของโครงร่างของวงกลม รูปแบบเส้นโครงร่างเริ่มต้นคือเส้นทึบ ซึ่งแสดงด้วย null

พารามิเตอร์
รูปแบบ ของเส้นโครงร่าง

สาธารณะ void setStrokeWidth (ความกว้างแบบลอย)

ตั้งค่าความกว้างของเส้นโครงร่าง

ความกว้างของเส้นโครงร่างคือความกว้าง (เป็นพิกเซลหน้าจอ) ของโครงร่างวงกลม ค่านี้ต้องเป็น 0 ขึ้นไป หากค่าเป็น 0 แสดงว่าไม่ได้วาดโครงร่าง ค่าเริ่มต้นคือ 10

พารามิเตอร์
ความกว้าง ความกว้างของเส้นโครงร่าง หน่วยเป็นพิกเซลของหน้าจอ
การขว้าง
IllegalArgumentException ถ้าความกว้างเป็นค่าลบ

โมฆะสาธารณะ setTag (แท็กออบเจ็กต์)

ตั้งค่าแท็กสำหรับแวดวง

คุณสามารถใช้พร็อพเพอร์ตี้นี้เพื่อเชื่อมโยง Object กับแวดวงนี้ได้ตามต้องการ ตัวอย่างเช่น Object อาจมีข้อมูลเกี่ยวกับสิ่งที่วงกลมนั้นเป็นตัวแทน วิธีนี้ง่ายกว่าการเก็บ Map<Circle, Object> แยกต่างหาก อีกตัวอย่างหนึ่งก็คือ คุณสามารถเชื่อมโยงรหัส String ที่ตรงกับรหัสจากชุดข้อมูลได้ Google Maps SDK สำหรับ Android จะไม่อ่านและเขียนพร็อพเพอร์ตี้นี้ คุณมีหน้าที่รับผิดชอบในการเรียกใช้ setTag(null) เพื่อล้างแท็กเมื่อไม่ต้องการใช้งานแล้ว เพื่อป้องกันไม่ให้หน่วยความจำรั่วไหลในแอป

พารามิเตอร์
แท็ก หาก Null แท็กจะถูกล้าง

โมฆะสาธารณะ setVisible (boolean visible)

ตั้งค่าการเปิดเผยของแวดวง

ถ้าวงกลมนี้ไม่ปรากฏ ก็จะไม่มีการวาด รัฐอื่นๆ ทั้งหมดจะถูกเก็บไว้ แวดวงจะแสดงขึ้นโดยค่าเริ่มต้น

พารามิเตอร์
มองเห็นได้ true เพื่อทำให้แวดวงนี้ปรากฏขึ้น ต้องการ false เพื่อซ่อนแวดวง

สาธารณะ โมฆะ setZIndex (Float zIndex)

ตั้งค่า zIndex

การวางซ้อน (เช่น วงกลม) ที่มี zIndice สูงกว่าจะแสดงอยู่เหนือดัชนีที่มีดัชนีต่ำกว่า

พารามิเตอร์
zIndex ค่า zIndex