โพลีไลน์คือรายการของจุด โดยส่วนของเส้นจะวาดระหว่างจุดต่อเนื่องกัน โพลีไลน์มีคุณสมบัติต่อไปนี้
- คะแนน
- จุดยอดของเส้น ส่วนของเส้นตรงจะถูกวาดระหว่างจุดต่อเนื่องกัน เส้นประกอบจะไม่ปิดโดยค่าเริ่มต้น ในการสร้างโพลีไลน์แบบปิด จุดเริ่มต้นและจุดสิ้นสุดต้องเหมือนกัน
- ความกว้าง
- ความกว้างของเส้นตรงในหน่วยพิกเซลหน้าจอ ความกว้างจะคงที่และไม่ขึ้นอยู่กับระดับการซูมของกล้อง ค่าเริ่มต้นคือ 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 | |
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 | |
void |
setGeodesic(ภูมิศาสตร์บูลีน)
กำหนดว่าจะวาดส่วนของเส้นแต่ละส่วนเป็นแบบภูมิศาสตร์หรือไม่
|
void |
setJointType(int JointType)
กำหนดประเภทข้อต่อสำหรับจุดยอดทั้งหมดของโพลีไลน์ ยกเว้นจุดยอดมุมเริ่มต้นและสิ้นสุด
|
void | |
void | |
void | |
void | |
void |
setTag(แท็กออบเจ็กต์)
ตั้งค่าแท็กสําหรับโพลีไลน์
|
void |
setVisible(แสดงบูลีน)
ตั้งค่าการแสดงผลของโพลีไลน์นี้
|
void |
setWidth(ความกว้างแบบลอย)
ตั้งค่าความกว้างของโพลีไลน์นี้
|
void |
setZIndex(Float zIndex)
ตั้งค่า z ดัชนีของโพลีไลน์นี้
|
ข้อมูลสรุปของเมธอดที่รับช่วงมา
วิธีการสาธารณะ
บูลีนสาธารณะ เท่ากับ (ออบเจ็กต์อื่นๆ)
สาธารณะ int getColor ()
ดึงสีของโพลีไลน์นี้
คิกรีเทิร์น
- ตามสีในรูปแบบ ARGB
สาธารณะ Cap getEndCap ()
รับค่าสูงสุดที่จุดยอดมุมสุดท้ายของโพลีไลน์นี้
คิกรีเทิร์น
- ประเภทของภาพปิดท้าย
สาธารณะ สตริง getId ()
รับรหัสของโพลีไลน์นี้ ID จะไม่ซ้ำกันใน Polylines ทั้งหมดบนแผนที่
คิกรีเทิร์น
- รหัสของโพลีไลน์นี้
สาธารณะ int getJointType ()
รับข้อมูลประเภทข้อต่อที่ใช้ที่จุดยอดทุกจุดของโพลีไลน์ ยกเว้นจุดยอดมุมเริ่มต้นและสิ้นสุด ดูค่าที่เป็นไปได้ใน JointType
คิกรีเทิร์น
- ประเภทข้อต่อ
สาธารณะ รายการ<PatternItem> getPattern ()
รับรูปแบบเส้นโครงร่างของโพลีไลน์นี้
คิกรีเทิร์น
- ของเส้นโครงร่าง
สาธารณะ รายการ<LatLng> getPoints ()
แสดงภาพรวมของจุดยอดของเส้นประกอบนี้ในขณะนี้ รายการที่แสดงผลเป็นสำเนาของรายการจุดยอด ดังนั้นการเปลี่ยนแปลงจุดยอดของโพลีไลน์จะไม่แสดงในรายการนี้ และการเปลี่ยนแปลงในรายการจะไม่แสดงผลโดยโพลีไลน์ หากต้องการเปลี่ยนจุดยอดของโพลีไลน์ ให้เรียก setPoints(List)
ออบเจ็กต์สาธารณะ 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)
Public void setPattern (List<PatternItem> format)
ตั้งค่ารูปแบบเส้นโครงร่างของเส้น รูปแบบเส้นโครงร่างเริ่มต้นคือรูปแบบทึบ ซึ่งแสดงด้วย null
พารามิเตอร์
รูปแบบ | ของเส้นโครงร่าง |
---|
สาธารณะ void setPoints (List<LatLng> คะแนน)
กำหนดจุดของเส้นนี้ วิธีนี้จะเป็นสำเนาของจุด ดังนั้นการเปลี่ยนแปลงเพิ่มเติมไปยัง points
จะไม่มีผลกับโพลีไลน์นี้
พารามิเตอร์
คะแนน | รายการของ LatLng ที่เป็นจุดยอดของเส้นประกอบ
|
---|
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ดัชนีของโพลีไลน์นี้ |
---|