รูปหลายเหลี่ยม

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

โครงร่าง

โครงร่างกำหนดโดยรายการจุดยอดแบบตามเข็มนาฬิกาหรือทวนเข็มนาฬิกา ทั้งนี้ ไม่จำเป็นเพื่อให้จุดเริ่มต้นและจุดหมายตรงกัน หากไม่ รูปหลายเหลี่ยมจะ ปิดโดยอัตโนมัติ ส่วนของเส้นตรงจะวาดระหว่างจุดติดกันของจุดใน ของ 2 ทิศทาง (ตะวันออกหรือตะวันตก)

หลุม

รูคือพื้นที่ภายในรูปหลายเหลี่ยมที่ไม่ถูกเติม มีการระบุหลุมใน ในลักษณะเดียวกับโครงร่าง รูต้องอยู่ภายในโครงร่างทั้งหมด หลายสกุลเงิน สามารถระบุหลุมได้ แต่ไม่สนับสนุนหลุมที่ทับซ้อนกัน

ความกว้างของเส้น

ความกว้างของส่วนของเส้นตรงในหน่วยพิกเซลของหน้าจอ ความกว้างคงที่และไม่ขึ้นกับความกว้างของกล้อง ระดับการซูม ค่าเริ่มต้นคือ 10

สีเส้น

สีส่วนของเส้นในรูปแบบ ARGB ซึ่งเป็นรูปแบบเดียวกับที่ Color ใช้ ค่าเริ่มต้นคือสีดำ (0xff000000)

ประเภทข้อต่อโรคหลอดเลือดสมอง

ประเภทข้อต่อจะกำหนดรูปร่างที่จะใช้เมื่อผนวกส่วนของเส้นที่อยู่ติดกันทั้งหมด จุดยอดของโครงร่างรูปหลายเหลี่ยม ดูประเภทข้อต่อที่รองรับได้ที่ JointType ค่าเริ่มต้นคือ DEFAULT

รูปแบบเส้นโครงร่าง

ทึบ (ค่าเริ่มต้นแสดงด้วย null) หรือลำดับของวัตถุ PatternItem เพื่อแสดงซ้ำตามขอบของรูปหลายเหลี่ยม ประเภท PatternItem ที่ใช้ได้: Gap (กำหนดด้วยความยาวของช่องว่างในหน่วยพิกเซล), Dash (กำหนดโดยความกว้างของเส้นโครงร่างและขีดกลาง ความยาวเป็นพิกเซล) และ Dot (วงกลม กึ่งกลางขอบของรูปหลายเหลี่ยม เส้นผ่านศูนย์กลาง กำหนดโดยความกว้างของเส้นโครงร่างเป็นพิกเซล)

เติมสี

เติมสีในรูปแบบ ARGB ซึ่งเป็นรูปแบบเดียวกับที่ Color ใช้ ค่าเริ่มต้นคือโปร่งใส (0x00000000) ถ้าไม่ได้ระบุเรขาคณิตของรูปหลายเหลี่ยม อย่างถูกต้อง (ดูโครงร่างและหลุมด้านบน) จะไม่มีการวาดสีเติม

ดัชนีลำดับ Z

ลำดับของการวาดรูปหลายเหลี่ยมตามการวางซ้อนอื่นๆ รวมถึง Polyline, Circle, GroundOverlay และ TileOverlay แต่ไม่ใช่ Marker วินาที ภาพซ้อนทับที่มีดัชนีลำดับ Z ใหญ่กว่าถูกวาดทับการวางซ้อนที่มีดัชนี Z ดัชนี z ลำดับของการวางซ้อนที่มีค่าดัชนี z เดียวกันนั้นไม่มีกฎเกณฑ์ ค่าเริ่มต้นคือ 0.

ระดับการแชร์

ระบุว่ารูปหลายเหลี่ยมปรากฏอยู่หรือมองไม่เห็น กล่าวคือเป็นรูปวาดบนแผนที่หรือไม่ CANNOT TRANSLATE ไม่มีการวาดรูปหลายเหลี่ยมที่มองไม่เห็น แต่ยังคงคุณสมบัติอื่นๆ ทั้งหมดของรูปหลายเหลี่ยมดังกล่าว ค่าเริ่มต้นคือ true ซึ่งก็คือมองเห็นได้

สถานะเรขาคณิต

ระบุว่าส่วนของรูปหลายเหลี่ยมควรวาดเป็นรูปเรขาคณิต ไม่ใช่ ที่เป็นเส้นตรงบนเส้นโครงเมอร์เคเตอร์ เส้นธรณีภาคเป็นเส้นทางที่สั้นที่สุดระหว่าง 2 ส่วน บนพื้นผิวโลก เส้นโค้งทรงกลมสร้างขึ้นโดยสมมติว่าโลกเป็น ทรงกลม

ความสามารถในการคลิกได้

หากคุณต้องการจัดการเหตุการณ์ที่เริ่มทำงานเมื่อผู้ใช้คลิกรูปหลายเหลี่ยม ให้ตั้งค่าพร็อพเพอร์ตี้นี้เป็น true คุณสามารถเปลี่ยนแปลงค่านี้ได้ตลอดเวลา โดยมีค่าเริ่มต้นเป็น false หากสิ่งนี้ พร็อพเพอร์ตี้ได้รับการตั้งค่าเป็น true แอปของคุณจะได้รับการแจ้งเตือนไปยัง GoogleMap.OnPolygonClickListener ที่ลงทะเบียนผ่าน setOnPolygonClickListener(GoogleMap.OnPolygonClickListener)

แท็ก

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

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

ตัวอย่าง

GoogleMap map;
 // ... get a map.
 // Add a triangle in the Gulf of Guinea
 Polygon polygon = map.addPolygon(new PolygonOptions()
     .add(new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5), new LatLng(0, 0))
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));
 

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

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