Polyline

折線是點清單，其中線段會在連續的點之間繪製。折線具有下列屬性：

積分

線條的頂點。線段會在連續點之間繪製。根據預設，折線「不會」關閉。如要形成封閉折線，起點和終點必須相同。

寬度

線段寬度，以螢幕像素為單位。寬度是常數，而且與相機的縮放等級無關。預設值為 10。

顏色

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

開始/結尾展示畫面

定義折線起點或終點使用的形狀。支援的上限類型：ButtCap、SquareCap、RoundCap (適用於純筆筆劃模式) 和 CustomCap (適用於任何筆劃模式)。起始和結束時間的預設值：ButtCap。

連接類型

連接類型用於定義折線所有頂點的相鄰線段 (起始和結束端點除外) 連接的形狀。如要瞭解支援的彙整類型，請參閱 JointType。預設值為 DEFAULT。

筆劃圖案

固定 (預設值，以 null 表示)，或是一組 PatternItem 物件，沿著線條重複使用。可用的 PatternItem 類型：Gap (由像素相距長度定義)、Dash (以線條寬度和破折號長度 (以像素為單位)) 和 Dot (圓形，位於線條中央，直徑定義為線條寬度)。

Z-Index

此圖塊疊加層相對於其他疊加層 (包括 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> 容易許多。在另一個範例中，您可以將與資料集 ID 對應的 String ID 建立關聯。Google Maps SDK for 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));
 

開發人員指南

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