圓形

公開最終類別 Circle 擴充物件

地球表面的圓形 (#39;)。

圓圈包含下列屬性。

中間
圓形的中心指定為 LatLng。
半徑
圓形的半徑，以公尺為單位。這個值必須為 0 以上。
筆劃寬度
圓形在螢幕像素外的寬度。寬度固定，且與相機的縮放等級無關。預設值為 10。
筆劃顏色
以 ARGB 格式顯示圓形外框的顏色，與 Color 使用的格式相同。預設值為黑色 (0xff000000)。
筆劃圖案
圓形 (預設由 null 表示) 或一系列 PatternItem 物件 (沿著圓形外框重複)。可用的 PatternItem 類型：Gap (由像素寬度的單位長度定義)、Dash (以筆劃寬度和虛線長度的像素定義) 和 Dot (以圓形為中心，以筆劃寬度為準，以像素為單位定義的直徑)。
填滿顏色
圓形的顏色是 ARGB 格式，與 Color 使用的格式相同。預設值為透明 (0x00000000)。
Z-index
此圖塊疊加層相對於其他疊加層的繪製順序 (包括 GroundOverlay、TileOverlay、Polyline、Polygon，但不是 Marker)。系統會將 Z-index 值較大的疊加層繪製在 Z 索引較低的疊加層上；具有相同 Z-index 的疊加層順序為任意順序。預設的 zIndex 為 0。
顯示設定
指出圓形是否可見，也就是是否在地圖上繪製。系統不會繪製隱形圓形，但會保留所有其他的屬性。預設值為 true，也就是可見。
標記
與社交圈關聯的 Object。舉例來說，Object 可包含圓形代表的資料。這種做法比儲存單獨的 Map<Circle, Object> 更輕鬆。另一個例子是，您可以將與 ID 對應的 String ID 與資料集建立關聯。Google 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));

請注意，如果圓形包含北極或南極，則目前地圖轉譯器無法繪製圓形。不過，我們仍可正確繪製大綱。

開發人員指南

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

公用方法摘要

LatLng
getCenter()
以 LatLng 傳回中心。
整數
getFillColor()
傳回這個圓形的填滿顏色。
字串
getId()
取得這個圓形的 ID。
雙倍
getRadius()
傳回圓的半徑，單位為公尺。
整數
getStrokeColor()
傳回筆劃顏色。
List<PatternItem>
getStrokePattern()
傳回這個圓形的外框筆劃圖案。
浮點值
getStrokeWidth()
傳回筆劃寬度。
物件
getTag()
取得圓形的標記。
浮點值
getZIndex()
傳回 zIndex。
布林
isClickable()
取得圓形的可點擊屬性。
布林
isVisible()
檢查圓圈是否可見。
void
remove()
從地圖中移除這個圓形。
void
setCenter(LatLng 中心)
使用 LatLng 設定中心。
void
setClickable(布林值可點擊)
設定圓形的可點擊屬性。
void
setFillColor (整數)
設定填滿顏色。
void
setRadius (雙半徑)
設定半徑 (單位為公尺)。
void
setStrokeColor (整數)
設定筆劃顏色。
void
setStrokePattern (清單<圖案項目> 模式)
設定圓形的筆劃圖案。
void
setStrokeWidth(浮動寬度)
設定筆劃寬度。
void
setTag (物件標記)
設定圓形的標記。
void
setVisible (布林值顯示)
設定圓形的顯示設定。
void
setZIndex(浮動值 zIndex)
設定 zIndex。

繼承方法摘要

公用方法

公開 LatLng getCenter ()

以 LatLng 傳回中心。

傳回

public int getFillColor()

傳回這個圓形的填滿顏色。

傳回
  • 圓形的 ARGB 格式填滿顏色。

public String getId ()

取得這個圓形的 ID。地圖上顯示的所有圓形 ID 不得重複。

public getRadius ()

傳回圓的半徑，單位為公尺。

傳回
  • 以公尺為單位的半徑。

public int getStrokeColor ()

傳回筆劃顏色。

傳回
  • 圓形的 ARGB 格式顏色。

public List<PatternItem> getStrokePattern ()

傳回這個圓形的外框筆劃圖案。

傳回
  • 筆劃圖案。

public float getStrokeWidth()

傳回筆劃寬度。

傳回
  • 螢幕像素寬度。

public Object getTag ()

取得圓形的標記。

傳回
  • 如使用 setTag 設定標記，如未設定標記則傳回 null。

public float getZIndex ()

傳回 zIndex。

傳回
  • 這個圓形的 ZIndex。

public 布林值 isClickable ()

取得圓形的可點擊屬性。如果圓圈是可點擊的，當使用者按一下圓圈，應用程式就會向 GoogleMap.OnCircleClickListener 發出通知。事件監聽器是透過 setOnCircleClickListener(GoogleMap.OnCircleClickListener) 註冊。

傳回
  • 如果圓圈為可點擊，則為 true；如果無法點擊，則為 false。

公開布林值 isVisible ()

檢查圓圈是否可見。

傳回
  • 如果圓圈未顯示，則為 true；如果隱藏，則為 false。

public 移除 ()

從地圖中移除這個圓形。移除圓形後，其中所有方法的行為皆未定義。

public void setCenter (LatLng center)

使用 LatLng 設定中心。

中心不得為空值，因為沒有預設值。

參數
中心 圓形的地理中心，指定為 LatLng。
擲回
NullPointerException 如果中間為空值，

public setClickable (布林值可點擊)

設定圓形的可點擊屬性。如果圓圈是可點擊的，當使用者按一下圓圈，應用程式就會向 GoogleMap.OnCircleClickListener 發出通知。事件監聽器是透過 setOnCircleClickListener(GoogleMap.OnCircleClickListener) 註冊。

參數
可點擊 圓形的可點擊設定。

public setFillColor (整數)

設定填滿顏色。

填滿顏色是圓形中的顏色，以 Color 指定的整數格式。如果使用 TRANSPARENT，則不會繪製任何填滿。

參數
顏色 Color 格式的顏色。

public setRadius (雙半徑)

設定半徑 (以公尺為單位)。

半徑必須為 0 以上。

參數
半徑 半徑 (以公尺為單位)。
擲回
IllegalArgumentException 如果半徑為負數，

public setStrokeColor(整數顏色)

設定筆劃顏色。

筆劃顏色是這個圓形的外框顏色，如 Color 所指定。如果使用 TRANSPARENT，則不會繪製任何外框。

參數
顏色 Color 格式的筆劃顏色。

public setStrokePattern(List<PatternItem>pattern)

設定圓形的筆劃圖案。預設的筆劃圖案為實心，以 null 表示。

參數
圖案 筆劃圖案。

public setStrokeWidth(浮點寬度)

設定筆劃寬度。

筆劃寬度是圓形外框的寬度 (以像素為單位)。這個值不得小於 0。如果為 0，則不會繪製任何外框。預設值為 10。

參數
寬度 筆劃寬度 (以螢幕像素為單位)。
擲回
IllegalArgumentException 如果寬度為負數

public setTag (物件標記)

設定圓形的標記。

您可以利用這項屬性將任意 Object 與這個圓形建立關聯。例如，Object 可能包含圓形代表的資料。這種做法比儲存單獨的 Map<Circle, Object> 更輕鬆。另一個例子是，您可以將 String 對應的 ID 與資料集中的 ID 建立關聯。Google Maps SDK for Android 不會讀取或寫入這項屬性。不再需要使用標記時，您必須呼叫 setTag(null) 清除標記，以免應用程式發生記憶體流失。

參數
標記 如果為空值，系統會清除標記。

public setVisible (布林值顯示)

設定圓形的顯示設定。

如果未看到這個圓圈，系統就不會繪製這個圓形。系統會保留所有其他狀態。根據預設，系統會顯示圓形。

參數
顯示 true；如要隱藏這個圓形，請使用 false。

public setZIndex(float zIndex)

設定 zIndex。

ZIndi 值較高的疊加層 (例如圓形) 會繪製在索引較低的圖層上。

參數
ZIndex zIndex 值。