เส้นประกอบ

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

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

คะแนน
จุดยอดของเส้น ส่วนของเส้นตรงจะถูกวาดระหว่างจุดต่อเนื่องกัน เส้นประกอบจะไม่ปิดโดยค่าเริ่มต้น ในการสร้างโพลีไลน์แบบปิด จุดเริ่มต้นและจุดสิ้นสุดต้องเหมือนกัน
ความกว้าง
ความกว้างของเส้นตรงในหน่วยพิกเซลหน้าจอ ความกว้างจะคงที่และไม่ขึ้นอยู่กับระดับการซูมของกล้อง ค่าเริ่มต้นคือ 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 เดียวกันจะเป็นแบบอิสระ zIndex เริ่มต้นคือ 0
ระดับการแชร์
ระบุว่าเส้นประกอบนั้นมองเห็นได้หรือไม่ เช่น เส้นประกอบนั้นวาดบนแผนที่หรือไม่ ระบบจะไม่วาดเส้นประกอบที่มองไม่เห็น แต่จะเก็บพร็อพเพอร์ตี้อื่นๆ ทั้งหมดไว้ ค่าเริ่มต้นคือ true นั่นคือแสดง
สถานะทางภูมิศาสตร์
ระบุว่าควรวาดส่วนของเส้นตรงเป็นเรขาคณิตแทนเส้นตรงบนเส้นโครงเมอร์เคเตอร์หรือไม่ ภูมิศาสตร์โลกเป็นเส้นทางที่สั้นที่สุดระหว่างจุด 2 จุดบนพื้นผิวโลก เส้นโค้งทางภูมิศาสตร์สร้างขึ้นโดยมีสมมติฐานว่าโลกเป็นทรงกลม
ความสามารถในการคลิกได้
หากต้องการจัดการเหตุการณ์ที่เริ่มทำงานเมื่อผู้ใช้คลิกโพลีไลน์ ให้ตั้งค่าพร็อพเพอร์ตี้นี้เป็น true คุณสามารถเปลี่ยนแปลงค่านี้ได้ตลอดเวลา ค่าเริ่มต้นคือ false หากตั้งค่าพร็อพเพอร์ตี้นี้เป็น true แอปของคุณจะได้รับการแจ้งเตือนไปยัง GoogleMap.OnPolylineClickListener ที่ลงทะเบียนจนถึงวันที่ setOnPolylineClickListener(GoogleMap.OnPolylineClickListener)
ติดแท็ก
Object ที่เชื่อมโยงกับเส้นประกอบ ตัวอย่างเช่น Object อาจมีข้อมูลเกี่ยวกับสิ่งที่เส้นแสดง วิธีนี้ง่ายกว่าการเก็บ Map<Polyline, Object> แยกต่างหาก อีกตัวอย่างหนึ่งก็คือ คุณสามารถเชื่อมโยงรหัส String ที่ตรงกับรหัสจากชุดข้อมูล Google Maps SDK สำหรับ Android จะไม่อ่านและเขียนพร็อพเพอร์ตี้นี้
Span
ระบุระยะเวลาด้วยรูปแบบต่างๆ ที่ใช้ในการแสดงผลโพลีไลน์นี้ คุณใช้พร็อพเพอร์ตี้นี้เพื่อสร้างโพลีไลน์ที่มี StrokeStyle ที่แตกต่างกันในส่วนต่างๆ ของเส้นได้

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

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

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

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

boolean
เท่ากับ(ออบเจ็กต์อื่นๆ)
ทดสอบว่า Polyline นี้เท่ากับอีกหรือไม่
int
getColor() แล้ว
ดึงสีของโพลีไลน์นี้
สูงสุด
getEndCap()
รับค่าสูงสุดที่จุดยอดมุมสุดท้ายของโพลีไลน์นี้
สตริง
getId()
รับรหัสของโพลีไลน์นี้
int
getJointType()
รับข้อมูลประเภทข้อต่อที่ใช้ที่จุดยอดทุกจุดของโพลีไลน์ ยกเว้นจุดยอดมุมเริ่มต้นและสิ้นสุด
List<PatternItem>
getPattern()
รับรูปแบบเส้นโครงร่างของโพลีไลน์นี้
List<LatLng>
getPoints()
แสดงภาพรวมของจุดยอดของเส้นประกอบนี้ในขณะนี้
สูงสุด
getStartCap()
รับค่าสูงสุดที่จุดยอดมุมเริ่มต้นของโพลีไลน์นี้
ออบเจ็กต์
getTag()
รับแท็กสำหรับโพลีไลน์
float
getWidth()
รับความกว้างของโพลีไลน์นี้
float
getZIndex()
รับดัชนี z ของโพลีไลน์นี้
int
hashCode()
boolean
isClickable()
รับความสามารถในการคลิกของโพลีไลน์
boolean
isGeodesic()
ระบุว่าแต่ละส่วนของเส้นถูกวาดเป็นภูมิศาสตร์เชิงภูมิศาสตร์หรือไม่
boolean
isVisible()
รับการเปิดเผยของโพลีไลน์นี้
void
remove()
นำเส้นประกอบนี้ออกจากแผนที่
void
setClickable(บูลีนที่คลิกได้)
ตั้งค่าความสามารถในการคลิกของโพลีไลน์
void
setColor(สี int)
ตั้งค่าสีของโพลีไลน์นี้
void
setEndCap(Cap endCap)
ตั้งค่าค่าสูงสุดที่จุดยอดมุมสุดท้ายของโพลีไลน์นี้
void
setGeodesic(ภูมิศาสตร์บูลีน)
กำหนดว่าจะวาดส่วนของเส้นแต่ละส่วนเป็นแบบภูมิศาสตร์หรือไม่
void
setJointType(int JointType)
กำหนดประเภทข้อต่อสำหรับจุดยอดทั้งหมดของโพลีไลน์ ยกเว้นจุดยอดมุมเริ่มต้นและสิ้นสุด
void
setPattern(รูปแบบ List<PatternItem>)
ตั้งค่ารูปแบบเส้นโครงร่างของเส้น
void
setPoints(แสดงรายการ<LatLng> คะแนน)
กำหนดจุดของเส้นนี้
void
setSpans(รายการ<StyleSpan> spans)
ตั้งค่าระยะเวลาของโพลีไลน์
void
setStartCap(Cap startCap)
ตั้งค่าค่าสูงสุดที่จุดยอดมุมเริ่มต้นของโพลีไลน์นี้
void
setTag(แท็กออบเจ็กต์)
ตั้งค่าแท็กสําหรับโพลีไลน์
void
setVisible(แสดงบูลีน)
ตั้งค่าการแสดงผลของโพลีไลน์นี้
void
setWidth(ความกว้างแบบลอย)
ตั้งค่าความกว้างของโพลีไลน์นี้
void
setZIndex(Float zIndex)
ตั้งค่า z ดัชนีของโพลีไลน์นี้

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

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

บูลีนสาธารณะ เท่ากับ (ออบเจ็กต์อื่นๆ)

ทดสอบว่า Polyline นี้เท่ากับอีกหรือไม่

พารามิเตอร์
อื่นๆ Object
คิกรีเทิร์น
  • เป็นจริงถ้าวัตถุทั้งสองเป็นวัตถุเดียวกัน นั่นคือ == other

สาธารณะ int getColor ()

ดึงสีของโพลีไลน์นี้

คิกรีเทิร์น
  • ตามสีในรูปแบบ ARGB

สาธารณะ Cap getEndCap ()

รับค่าสูงสุดที่จุดยอดมุมสุดท้ายของโพลีไลน์นี้

คิกรีเทิร์น
  • ประเภทของภาพปิดท้าย

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

รับรหัสของโพลีไลน์นี้ ID จะไม่ซ้ำกันใน Polylines ทั้งหมดบนแผนที่

คิกรีเทิร์น
  • รหัสของโพลีไลน์นี้

สาธารณะ int getJointType ()

รับข้อมูลประเภทข้อต่อที่ใช้ที่จุดยอดทุกจุดของโพลีไลน์ ยกเว้นจุดยอดมุมเริ่มต้นและสิ้นสุด ดูค่าที่เป็นไปได้ใน JointType

คิกรีเทิร์น
  • ประเภทข้อต่อ

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

รับรูปแบบเส้นโครงร่างของโพลีไลน์นี้

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

สาธารณะ รายการ<LatLng> getPoints ()

แสดงภาพรวมของจุดยอดของเส้นประกอบนี้ในขณะนี้ รายการที่แสดงผลเป็นสำเนาของรายการจุดยอด ดังนั้นการเปลี่ยนแปลงจุดยอดของโพลีไลน์จะไม่แสดงในรายการนี้ และการเปลี่ยนแปลงในรายการจะไม่แสดงผลโดยโพลีไลน์ หากต้องการเปลี่ยนจุดยอดของโพลีไลน์ ให้เรียก setPoints(List)

สาธารณะ Cap getStartCap ()

รับค่าสูงสุดที่จุดยอดมุมเริ่มต้นของโพลีไลน์นี้

คิกรีเทิร์น
  • ค่าเริ่มต้น

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

รับแท็กสำหรับโพลีไลน์

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

แบบลอยสาธารณะ getWidth ()

รับความกว้างของโพลีไลน์นี้

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

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

รับดัชนี z ของโพลีไลน์นี้

คิกรีเทิร์น
  • z Index ของโพลีไลน์

สาธารณะ int hashCode ()

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

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

คิกรีเทิร์น
  • true หากโพลีไลน์คลิกได้ มิเช่นนั้น จะแสดงผล false

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

ระบุว่าแต่ละส่วนของเส้นถูกวาดเป็นภูมิศาสตร์เชิงภูมิศาสตร์หรือไม่

คิกรีเทิร์น
  • true หากวาดแต่ละส่วนเป็นภูมิศาสตร์ false หากแต่ละส่วนวาดเป็นเส้นตรงบนเส้นโครงเมอร์เคเตอร์

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

รับการเปิดเผยของโพลีไลน์นี้

คิกรีเทิร์น
  • การมองเห็นของเส้นประกอบนี้

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

นำเส้นประกอบนี้ออกจากแผนที่ หลังจากนำโพลีไลน์ออกแล้ว ระบบจะไม่ระบุลักษณะการทำงานของเมธอดทั้งหมด

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

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

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

โมฆะสาธารณะ setColor (int color)

ตั้งค่าสีของโพลีไลน์นี้

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

สาธารณะ void setEndCap (Cap endCap)

ตั้งค่าค่าสูงสุดที่จุดยอดมุมสุดท้ายของโพลีไลน์นี้ ภาพปิดท้ายเริ่มต้นคือ ButtCap

พารามิเตอร์
endCap ภาพปิดท้าย ต้องเป็น null

โมฆะสาธารณะ setGeodesic (boolean geodesic)

กำหนดว่าจะวาดส่วนของเส้นแต่ละส่วนเป็นแบบภูมิศาสตร์หรือไม่

พารามิเตอร์
ภูมิศาสตร์ หากเป็น true ระบบจะวาดแต่ละส่วนเป็นภูมิศาสตร์ หากเป็น false แต่ละส่วนจะถูกวาดเป็นเส้นตรงบนเส้นโครงเมอร์เคเตอร์

โมฆะ สาธารณะ setJointType (int partnerType)

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

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

พารามิเตอร์
jointType ประเภทข้อต่อ

Public void setPattern (List<PatternItem> format)

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

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

สาธารณะ void setPoints (List<LatLng> คะแนน)

กำหนดจุดของเส้นนี้ วิธีนี้จะเป็นสำเนาของจุด ดังนั้นการเปลี่ยนแปลงเพิ่มเติมไปยัง points จะไม่มีผลกับโพลีไลน์นี้

พารามิเตอร์
คะแนน รายการของ LatLng ที่เป็นจุดยอดของเส้นประกอบ

สาธารณะ void setSpans (ระยะเวลา รายการ<StyleSpan>)

ตั้งค่าระยะเวลาของโพลีไลน์

พารามิเตอร์
ระยะเวลา

Public void setStartCap (Cap startCap)

ตั้งค่าค่าสูงสุดที่จุดยอดมุมเริ่มต้นของโพลีไลน์นี้ ค่าเริ่มต้นของขีดจำกัดเริ่มต้นคือ ButtCap

พารามิเตอร์
startCap ขีดจำกัดเริ่มต้น ต้องเป็น null

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

ตั้งค่าแท็กสําหรับโพลีไลน์

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

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

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

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

พารามิเตอร์
มองเห็นได้ ถ้าเป็น true เส้นจะปรากฏให้เห็น แต่ถ้าเป็น false จะไม่แสดง

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

ตั้งค่าความกว้างของโพลีไลน์นี้

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

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

ตั้งค่า z ดัชนีของโพลีไลน์นี้ โพลีไลน์ที่มี zIndice สูงกว่าจะแสดงเหนือเส้นที่มีดัชนีต่ำกว่า

พารามิเตอร์
zIndex zดัชนีของโพลีไลน์นี้