地表面上の円(球面キャップ)。
円には次のプロパティがあります。
- 中央
- 円の中心は
LatLng
として指定します。 - 半径
- 円の半径。メートル単位で指定します。0 以上の値にしてください。
- ストロークの幅
- 画面ピクセルに合わせた円の輪郭の幅。幅は一定であり、カメラのズームレベルとは無関係です。デフォルト値は 10 です。
- ストロークの色
- 円のアウトラインの色。
Color
で使用されているものと同じ ARGB 形式です。デフォルト値は黒(0xff000000
)です。 - ストロークのパターン
- 単色(デフォルト、
null
で表される)または円の輪郭に沿って繰り返される一連のPatternItem
オブジェクト使用可能なPatternItem
タイプ:Gap
(ピクセル単位のギャップ長で定義)、Dash
(ストロークの幅とダッシュの長さで定義)、Dot
(円形、中心に配置し、ストロークの幅をピクセル単位で指定) - 塗りつぶしの色
Color
で使用されているものと同じ形式の ARGB 形式で塗りつぶされた円の色。デフォルト値は透明(0x00000000
)です。- Z-Index
- 他のオーバーレイに対するこのタイル オーバーレイの描画順序(
GroundOverlay
、TileOverlay
、Polyline
、Polygon
など。ただしMarker
は含まない)。z インデックスが大きいオーバーレイは、z インデックスが小さいオーバーレイの上に描画されます。z インデックスが同じオーバーレイの順序は任意です。デフォルトの 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 を取得します。
|
double |
getRadius()
円の半径をメートル単位で返します。
|
整数 |
getStrokeColor()
ストロークの色を返します。
|
List<PatternItem> |
getStrokePattern()
この円の輪郭のストローク パターンを返します。
|
浮動小数点数 |
getStrokeWidth()
ストロークの幅を返します。
|
オブジェクト |
getTag()
円のタグを取得します。
|
浮動小数点数 |
getZIndex()
zIndex を返します。
|
ブール値 |
isClickable()
円のクリック可能性を取得します。
|
ブール値 |
isVisible()
円が表示されているかどうかを確認します。
|
void |
remove()
地図からこの円を削除します。
|
void | |
void |
setClickable(クリック可能なブール値)
円のクリック可能性を設定します。
|
void |
setFillColor(int color)
塗りつぶしの色を設定します。
|
void |
setRadius(double radius)
半径をメートル単位で設定します。
|
void |
setStrokeColor(int color)
ストロークの色を設定します。
|
void | |
void |
setStrokeWidth(浮動小数点幅)
ストロークの幅を設定します。
|
void |
setTag(オブジェクト タグ)
円のタグを設定します。
|
void |
setVisible(ブール値を表示)
円の公開設定を指定します。
|
void |
setZIndex(浮動小数点数の zIndex)
zIndex を設定します。
|
継承されたメソッドの概要
パブリック メソッド
public int getFillColor ()
この円の塗りつぶし色を返します。
戻り値
- 円の塗りつぶしの色(ARV 形式)。
公開 文字列 getId ()
この円の ID を取得します。ID は、地図上のすべての円の中で一意です。
public double getRadius ()
円の半径をメートル単位で返します。
戻り値
- 半径(メートル単位)。
public int getStrokeColor ()
ストロークの色を返します。
戻り値
- 円の色(ARB 形式)。
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 (ブール値のクリック可能)
円のクリック可能性を設定します。円がクリック可能な場合、ユーザーが円をクリックすると、アプリは GoogleMap.OnCircleClickListener
に通知を受け取ります。イベント リスナーは setOnCircleClickListener(GoogleMap.OnCircleClickListener)
を介して登録されます。
パラメータ
クリックできます | 円の新しいクリック設定。 |
---|
public void setFillColor (int color)
public void setRadius (double radius)
半径をメートル単位で設定します。
半径は 0 以上の値にしてください。
パラメータ
半径 | 半径(メートル単位)。 |
---|
スロー値
IllegalArgumentException | 半径が負の場合 |
---|
public void setStrokeColor (int color)
public void setStrokePattern (List<PatternItem> pattern)
円のストローク パターンを設定します。デフォルトのストローク パターンは単色で、null
で表されます。
パラメータ
pattern | ストロークのパターン。 |
---|
public void setStrokeWidth (浮動小数点幅)
ストロークの幅を設定します。
ストロークの幅は、円の輪郭線の幅(画面ピクセル単位)です。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 (ブール値の表示)
円の公開設定を指定します。
この円が表示されない場合、このテキストは描画されません。その他の状態はすべて保持されます。円はデフォルトで表示されます。
パラメータ
表示 | この円を表示する場合は true 、非表示にする場合は false に設定します。 |
---|
public void setZIndex (浮動小数点数 zIndex)
zIndex を設定します。
z インジケーターの高いオーバーレイ(円など)は、インデックスが小さいオーバーレイより上に描画されます。
パラメータ
Z-index | zIndex 値。 |
---|