วงกลมบนพื้นผิวโลก (หมวกทรงกลม)
วงกลมมีคุณสมบัติดังต่อไปนี้
- เซ็นเตอร์
- ระบุจุดศูนย์กลางของวงกลมเป็น
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 | |
int |
getFillColor()
แสดงสีเติมของวงกลมนี้
|
สตริง |
getId()
รับรหัสของแวดวงนี้
|
คู่ |
getRadius()
แสดงรัศมีของวงกลมเป็นเมตร
|
int |
getStrokeColor()
แสดงสีของเส้นโครงร่าง
|
List<PatternItem> |
getStrokePattern()
แสดงรูปแบบเส้นโครงร่างของโครงร่างวงกลมนี้
|
float |
getStrokeWidth()
แสดงความกว้างของเส้นโครงร่าง
|
ออบเจ็กต์ |
getTag()
รับแท็กสำหรับแวดวงนี้
|
float |
getZIndex()
แสดง zIndex
|
boolean |
isClickable()
รับความสามารถในการคลิกของแวดวง
|
boolean |
isVisible()
ตรวจสอบว่าวงกลมดังกล่าวมองเห็นหรือไม่
|
void |
remove()
นำวงกลมนี้ออกจากแผนที่
|
void | |
void |
setClickable(บูลีนที่คลิกได้)
ตั้งค่าความสามารถในการคลิกของวงกลม
|
void |
setFillColor(สี int)
ตั้งค่าสีเติม
|
void |
setRadius(รัศมีคู่)
กำหนดรัศมีเป็นเมตร
|
void |
setStrokeColor(สี)
ตั้งค่าสีของเส้น
|
void | |
void |
setStrokeWidth(ความกว้างแบบลอย)
ตั้งค่าความกว้างของเส้นโครงร่าง
|
void |
setTag(แท็กออบเจ็กต์)
ตั้งค่าแท็กสำหรับแวดวง
|
void |
setVisible(แสดงบูลีน)
ตั้งค่าการเปิดเผยของแวดวง
|
void |
setZIndex(Float zIndex)
ตั้งค่า zIndex
|
ข้อมูลสรุปของเมธอดที่รับช่วงมา
วิธีการสาธารณะ
สาธารณะ LatLng getCenter ()
สาธารณะ 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)
โมฆะสาธารณะ setClickable (บูลีนที่คลิกได้)
ตั้งค่าความสามารถในการคลิกของวงกลม หากวงกลมนั้นคลิกได้ แอปจะได้รับการแจ้งเตือนไปยัง GoogleMap.OnCircleClickListener
เมื่อผู้ใช้คลิกวงกลม
Listener เหตุการณ์ได้รับการลงทะเบียนจนถึงวันที่ setOnCircleClickListener(GoogleMap.OnCircleClickListener)
พารามิเตอร์
คลิกได้ | การตั้งค่าความสามารถในการคลิกได้ใหม่สำหรับแวดวง |
---|
โมฆะสาธารณะ setFillColor (สี int)
โมฆะสาธารณะ setRadius (รัศมีสองเท่า)
กำหนดรัศมีเป็นเมตร
รัศมีต้องเป็น 0 หรือมากกว่า
พารามิเตอร์
รัศมี | รัศมี หน่วยเป็นเมตร |
---|
การขว้าง
IllegalArgumentException | ถ้ารัศมีเป็นค่าลบ |
---|
โมฆะสาธารณะ setStrokeColor (สีแต้ม)
สาธารณะ 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 |
---|