地表面上の円(球面キャップ)。
円には次の特性があります。
- 中心
- 円の中心は
LatLng
として指定します。 - 半径
- 円の半径(メートル単位)。ゼロ以上の値を指定してください。
- ストロークの幅
- 円の枠線の幅(画面のピクセル)。幅は一定で、カメラのズームレベルに依存しません。デフォルト値は 10 です。
- ストロークの色
- 円の枠線の色。
Color
で使用されているのと同じ ARGB 形式で指定します。デフォルト値は黒(0xff000000
)です。 - ストロークのパターン
- 単色(デフォルト、
null
で表されます)または円の枠線に沿って繰り返される一連のPatternItem
オブジェクト。利用可能なPatternItem
型:Gap
(ピクセル単位のギャップの長さで定義)、Dash
(ピクセル単位のストローク幅とダッシュの長さで定義)、Dot
(円形、円の輪郭の中央に配置、直径はストローク幅(ピクセル単位)で定義)。 - 塗りつぶしの色
- 円の塗りつぶしの色。
Color
で使用されているのと同じ ARGB 形式で指定します。デフォルト値は透明(0x00000000
)です。 - Z インデックス
- 他のオーバーレイ(
GroundOverlay
、TileOverlay
、Polyline
、Polygon
など。Marker
は除く)に対する、このタイル オーバーレイの描画順序。Z-Index の大きいオーバーレイは、小さい Z-Index のオーバーレイの上に描画されます。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 | |
整数 |
getFillColor()
この円の塗りつぶしの色を返します。
|
文字列 |
getId()
このサークルの ID を取得します。
|
倍精度 |
getRadius()
円の半径をメートル単位で返します。
|
整数 |
getStrokeColor()
ストロークの色を返します。
|
List<PatternItem> |
getStrokePattern()
この円の枠線のストローク パターンを返します。
|
浮動小数点数 |
getStrokeWidth()
ストロークの幅を返します。
|
オブジェクト |
getTag()
円のタグを取得します。
|
浮動小数点数 |
getZIndex()
zIndex を返します。
|
ブール値 |
isClickable()
円のクリック可能性を取得します。
|
ブール値 |
isVisible()
円が表示されているかどうかを確認します。
|
void |
remove()
この円を地図から削除します。
|
void | |
void |
setClickable(ブール値のクリック able)
円のクリック可能性を設定します。
|
void |
setFillColor(int 色)
塗りつぶしの色を設定します。
|
void |
setRadius(倍精度半径)
半径をメートル単位で設定します。
|
void |
setStrokeColor(int 色)
ストロークの色を設定します。
|
void | |
void |
setStrokeWidth(浮動小数点数の幅)
ストロークの幅を設定します。
|
void |
setTag(オブジェクト タグ)
円にタグを設定します。
|
void |
setVisible(ブール値を表示)
円の表示設定を設定します。
|
void |
setZIndex(float zIndex)
zIndex を設定します。
|
継承されたメソッドの概要
パブリック メソッド
public int getFillColor ()
この円の塗りつぶしの色を返します。
戻り値
- 円の塗りつぶしの色(ARGB 形式)。
public String getId ()
このサークルの ID を取得します。ID は地図上のすべてのサークルで一意です。
public double getRadius ()
円の半径をメートル単位で返します。
戻り値
- 半径(メートル単位)。
public int getStrokeColor ()
ストロークの色を返します。
戻り値
- 円の色(ARGB 形式)。
public float getStrokeWidth ()
ストロークの幅を返します。
戻り値
- 幅(画面のピクセル数)。
public Object getTag ()
円のタグを取得します。
戻り値
setTag
でタグが設定された場合はタグ、タグが設定されていない場合はnull
。
public float getZIndex ()
zIndex を返します。
戻り値
- この円の zIndex。
public boolean isClickable ()
円のクリック可能性を取得します。円がクリック可能な場合、ユーザーが円をクリックしたときに、アプリは GoogleMap.OnCircleClickListener
に通知を受け取ります。イベント リスナーは setOnCircleClickListener(GoogleMap.OnCircleClickListener)
を介して登録されます。
戻り値
- 円がクリック可能な場合は
true
、クリックできない場合はfalse
です。
public boolean isVisible ()
円が表示されているかどうかを確認します。
戻り値
- 円が表示されている場合は
true
、非表示の場合はfalse
。
public void remove ()
この円を地図から削除します。円が削除された後は、そのすべてのメソッドの動作が定義されません。
public void setCenter (LatLng center)
public void setClickable (boolean clickable)
円のクリック可能性を設定します。円がクリック可能な場合、ユーザーが円をクリックしたときに、アプリは GoogleMap.OnCircleClickListener
に通知を受け取ります。イベント リスナーは setOnCircleClickListener(GoogleMap.OnCircleClickListener)
を介して登録されます。
パラメータ
クリックできます | 円のクリック可能性に関する新しい設定。 |
---|
public void setFillColor (int 色)
public void setRadius (double radius)
半径をメートル単位で設定します。
半径には 0 以上の値を指定してください。
パラメータ
半径 | 半径(メートル単位)。 |
---|
例外
IllegalArgumentException | 半径が負の値の場合 |
---|
public void setStrokeColor (int 色)
public void setStrokePattern (List<PatternItem> パターン)
円の枠線のストローク パターンを設定します。デフォルトのストローク パターンは無地で、null
で表されます。
パラメータ
パターン | ストロークのパターンを指定します。 |
---|
public void setStrokeWidth (float の幅)
ストロークの幅を設定します。
ストロークの幅は、円の輪郭の幅(画面のピクセル単位)です。0 以上の値にする必要があります。ゼロの場合、枠線は描画されません。デフォルト値は 10 です。
パラメータ
width | ストロークの幅(画面のピクセル単位)。 |
---|
例外
IllegalArgumentException | 幅が負の値の場合 |
---|
public void setTag (オブジェクト タグ)
円のタグを設定します。
このプロパティを使用すると、任意の Object
をこの円に関連付けることができます。たとえば Object
には、円が表す内容に関するデータを含めることができます。この方法は、個別の Map<Circle, Object>
を保存するよりも簡単です。別の例として、データセットの ID に対応する String
ID を関連付けることができます。Google Maps SDK for Android は、このプロパティの読み取りも書き込みも行いません。アプリでのメモリリークを防ぐため、不要になった場合は、setTag(null)
を呼び出してタグをクリアする必要があります。
パラメータ
タグ | null の場合、タグは消去されます。 |
---|
public void setVisible (boolean visible)
円の可視性を設定します。
この円が表示されない場合、描画されません。その他の状態はすべて保持されます。 円はデフォルトで表示されます。
パラメータ
表示 | この円を表示する場合は true 、非表示にする場合は false を指定します。
|
---|
public void setZIndex (float zIndex)
zIndex を設定します。
zIndex が高いオーバーレイ(円など)は、低いインデックスを持つオーバーレイより上に描画されます。
パラメータ
zIndex | zIndex の値。 |
---|