เส้นประกอบ

เส้นประกอบคือรายการของจุดที่มีการวาดส่วนของเส้นระหว่างจุดติดกัน ต โพลีไลน์มีคุณสมบัติดังต่อไปนี้

คะแนน

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

ความกว้าง

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

สี

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

ภาพเริ่มต้น/ภาพปิดท้าย

กำหนดรูปร่างที่จะใช้เมื่อเริ่มต้นหรือสิ้นสุดเส้นประกอบ ประเภทขีดจำกัดที่รองรับ: ButtCap, SquareCap, RoundCap (ใช้ได้กับรูปแบบเส้นทึบ) และ CustomCap (ใช้ได้กับรูปแบบเส้นโครงร่างใดๆ) ค่าเริ่มต้นสำหรับทั้งจุดเริ่มต้นและจุดสิ้นสุด: ButtCap

ประเภทข้อต่อ

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

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

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

ดัชนีลำดับ Z

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

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

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

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

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

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

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

แท็ก

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

Span

กำหนดระยะเวลาด้วยสไตล์ต่างๆ ที่ใช้ในการแสดงผลเส้นประกอบนี้ คุณใช้ เพื่อสร้างเส้นประกอบที่มี StrokeStyle ที่แตกต่างกันในกลุ่มของ เส้นประกอบ

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

ตัวอย่าง

GoogleMap map;
 // ... get a map.
 // Add a thin red line from London to New York.
 Polyline line = map.addPolyline(new PolylineOptions()
     .add(new LatLng(51.5, -0.1), new LatLng(40.7, -74.0))
     .width(5)
     .color(Color.RED));
 

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

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