Polygon

地球表面上的多邊形。多邊形可以是凸面或斜體，可以橫跨 180 個 而且可能有未填滿的孔。並包含下列屬性：

輪廓

外框是由以順時針或逆時針順序的端點清單指定。這項服務 不需要更改起點和終點；如果沒有，多邊形 線段是由較短的連續點之間繪製 (東或西)。

孔洞

孔是多邊形中未填滿的區域。坑洞位置 與外框相同輪廓必須完全包含在輪廓中。多個 可指定孔，但是不支援重疊的孔。

筆劃寬度

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

筆劃顏色

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

筆劃接頭類型

連接類型定義了要用於彙整相鄰線段的形狀 多邊形輪廓的頂點。如要瞭解支援的彙整類型，請參閱 JointType。 預設值為 DEFAULT。

筆劃圖案

實線 (預設，以 null 表示) 或 PatternItem 物件的序列 和多邊形的外框重複。可用的 PatternItem 類型：Gap (以像素長度定義)、Dash (以筆劃寬度和破折號定義) 以像素為單位) 和 Dot (圓形、以多邊形的輪廓為中心，直徑為中心) 定義)。

填滿顏色

使用 ARGB 格式填滿顏色，與 Color 所使用的格式相同。 預設值為透明 (0x00000000)。如果未指定多邊形幾何圖形 正確 (請參閱上述的 Outline 和 Holes)，則不會繪製任何填滿。

Z 索引

這個多邊形與其他疊加層之間的繪製順序，包括 Polyline、Circle、GroundOverlay 和 TileOverlay，但不包括 Marker 秒。系統會將 Z-index 值較大的疊加層繪製在較小的疊加層上 Z 索引。如果疊加層的 Z-index 值相同，則疊加順序是隨機決定的。預設值為 0.

能見度

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

測地線狀態

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

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

可點擊屬性

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

標記

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

此類別中的方法必須在 Android UI 執行緒上呼叫。否則會在執行階段擲回 IllegalStateException。

範例

GoogleMap map;
 // ... get a map.
 // Add a triangle in the Gulf of Guinea
 Polygon polygon = map.addPolygon(new PolygonOptions()
     .add(new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5), new LatLng(0, 0))
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));
 

開發人員指南

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