Circle

地球表面 (球形帽) 的圓形。

圓形具有下列屬性。

置中對齊

圓形的中心會指定為 LatLng。

半徑

圓形的半徑，以公尺為單位。應等於或大於零。

筆劃寬度

圓形的外框寬度，以螢幕像素為單位。寬度保持不變且獨立 以及相機縮放等級的範圍預設值為 10。

筆劃顏色

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

筆劃圖案

實線 (預設，以 null 表示) 或 PatternItem 物件的序列 沿著圓圈的輪廓重複。可用的PatternItem類型：Gap (以像素為單位定義)，Dash (由 像素) 和 Dot (以圓形的輪廓為中心，直徑為 筆劃寬度 (以像素為單位)。

填滿顏色

圓形的顏色會以 ARGB 格式填滿，與 Color 所使用的格式相同。預設值為透明 (0x00000000)。

Z 索引

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

能見度

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

標記

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

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

範例

GoogleMap map;
 // ... get a map.
 // Add a circle in Sydney
 Circle circle = map.addCircle(new CircleOptions()
     .center(new LatLng(-33.87365, 151.20689))
     .radius(10000)
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));
 

請注意，如果 包含北極旗標或南極桿。但輪廓仍會繪製 正確。

開發人員指南

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