Polyline

折線是點的清單，其中的線段會在不同的連續點之間繪製。A 罩杯 折線的特性如下：

積分

線條的頂點。線段會在連續點之間繪製。折線是 非關閉中；如要形成封閉的折線，起點和終點必須是 而且都一樣。

寬度

螢幕像素中的線段寬度。寬度會固定，獨立於相機的 或縮放等級。預設值為 10。

彩色

採用 ARGB 格式的線段顏色，與 Color 所使用的格式相同。 預設值為黑色 (0xff000000)。

開始/結尾展示畫面

定義要用於折線開頭或結尾的形狀。支援的上限類型：ButtCap、SquareCap、RoundCap (適用於單色筆劃圖案) 和 CustomCap (適用於任何筆劃圖案)。開始與結束的預設選項： ButtCap。

關節類型

連接類型定義了要用於彙整相鄰線段的形狀 折線的頂點和結束端點除外。請參閱 JointType： 支援的彙整類型。預設值為 DEFAULT。

筆劃圖案

實線 (預設，以 null 表示) 或 PatternItem 物件的序列 可以重複進行相同步驟可用的 PatternItem 類型：Gap (定義 間隔長度 (以像素為單位)、Dash (以線條寬度和破折號長度定義，以像素為單位) 以及 Dot (在線條中央，以線條寬度定義直徑)。

Z 索引

此圖塊疊加層與其他疊加層的繪製順序 (包括 GroundOverlay、TileOverlay、Circle 和 Polygon，但不包含 Marker)。系統會將 Z-index 值較大的疊加層繪製在較小的疊加層上 Z 索引。如果疊加層的 Z-index 值相同，則疊加順序是隨機決定的。預設的 zIndex 為 0.

能見度

指出折線是否可見或隱藏，亦即是否在地圖上繪製。一個 隱形折線不會繪製，但會保留所有其他屬性。預設值為 true，也就是可見。

測地線狀態

指出折線的線段是否應繪製為測地線，而非 麥卡托投影上的直線。測地線是兩條線之間的最短路徑 就會發生故障並假設地球為 球體

，瞭解如何調查及移除這項存取權。

可點擊屬性

如要處理使用者點選折線時觸發的事件，請將這個屬性設為 true。您隨時可以變更這個值。預設值為 false。如果這是 屬性設為 true，您的應用程式將收到透過 setOnPolylineClickListener(GoogleMap.OnPolylineClickListener) 註冊的 GoogleMap.OnPolylineClickListener 通知。

標記

與折線相關聯的 Object。例如，Object 可以包含 折線所代表意義的相關資料這種做法比儲存單獨的 Map<Polyline, Object> 更簡單。另一個範例是，您可以將 String ID 對應至資料集的 IDGoogle Maps SDK for Android 未讀取和 寫入此屬性。

時距數量

以不同樣式定義跨距，用來算繪這條折線。您可以使用 屬性建立在 不同路段上具有不同 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));
 

開發人員指南

詳情請參閱「形狀」開發人員 指南。