วงกลม

ชั้นเรียนสุดท้ายแบบสาธารณะ แวดวง ขยายออบเจ็กต์

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

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

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

ต้องเรียกใช้เมธอดในคลาสนี้บนเทรด Android UI หากไม่เป็นเช่นนั้น 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));

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

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

โปรดอ่านข้อมูลเพิ่มเติมจากนักพัฒนาซอฟต์แวร์ Shapes

ข้อมูลสรุปของเมธอดสาธารณะ

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

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

ค่ากลางต้องเป็นค่าว่าง เนื่องจากไม่มีค่าเริ่มต้น

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

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

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

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

สาธารณะ เป็นโมฆะ setFillColor (สีเติม)

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

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

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

สาธารณะ เป็นโมฆะ setRadius (รัศมีคู่)

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

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

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

สาธารณะ เป็นโมฆะ setStrokeColor (สีเติม)

ตั้งค่าสีเส้นโครงร่าง

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

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

สาธารณะ เป็นโมฆะ setStrokePattern (ลาย <PatternItem>)

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

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

สาธารณะ เป็นโมฆะ setStrokeWidth (ความกว้างแบบลอย)

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

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

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

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

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

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

พารามิเตอร์
แท็ก หากเป็นค่าว่าง ระบบจะล้างแท็ก

สาธารณะ เป็นโมฆะ setVisible (แสดงบูลีน)

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

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

พารามิเตอร์
มองเห็นได้ true เพื่อแสดงแวดวงนี้ falseเพื่อทำให้ซ่อนตัวได้

สาธารณะ เป็นโมฆะ setZIndex (ดัชนี z แบบลอย)

ตั้งค่า zIndex

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

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