Public final クラス Circle が Object を拡張します

地表面上の円(球面キャップ)。

円には次のプロパティがあります。

中央
円の中心は LatLng として指定します。
半径
円の半径。メートル単位で指定します。0 以上の値にしてください。
ストロークの幅
画面ピクセルに合わせた円の輪郭の幅。幅は一定であり、カメラのズームレベルとは無関係です。デフォルト値は 10 です。
ストロークの色
円のアウトラインの色。Color で使用されているものと同じ ARGB 形式です。デフォルト値は黒(0xff000000)です。
ストロークのパターン
単色(デフォルト、null で表される)または円の輪郭に沿って繰り返される一連の PatternItem オブジェクト使用可能な PatternItem タイプ: Gap(ピクセル単位のギャップ長で定義)、Dash(ストロークの幅とダッシュの長さで定義)、Dot(円形、中心に配置し、ストロークの幅をピクセル単位で指定)
塗りつぶしの色
Color で使用されているものと同じ形式の ARGB 形式で塗りつぶされた円の色。デフォルト値は透明(0x00000000)です。
Z-Index
他のオーバーレイに対するこのタイル オーバーレイの描画順序(GroundOverlayTileOverlayPolylinePolygon など。ただし 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
getCenter()
中心を LatLng として返します。
整数
getFillColor()
この円の塗りつぶし色を返します。
文字列
getId()
この円の ID を取得します。
double
getRadius()
円の半径をメートル単位で返します。
整数
getStrokeColor()
ストロークの色を返します。
List<PatternItem>
getStrokePattern()
この円の輪郭のストローク パターンを返します。
浮動小数点数
getStrokeWidth()
ストロークの幅を返します。
オブジェクト
getTag()
円のタグを取得します。
浮動小数点数
getZIndex()
zIndex を返します。
ブール値
isClickable()
円のクリック可能性を取得します。
ブール値
isVisible()
円が表示されているかどうかを確認します。
void
remove()
地図からこの円を削除します。
void
setCenterLatLng center)
LatLng を使用して中心を設定します。
void
setClickable(クリック可能なブール値)
円のクリック可能性を設定します。
void
setFillColor(int color)
塗りつぶしの色を設定します。
void
setRadius(double radius)
半径をメートル単位で設定します。
void
setStrokeColor(int color)
ストロークの色を設定します。
void
setStrokePattern(List<PatternItem> pattern)
円のストローク パターンを設定します。
void
setStrokeWidth(浮動小数点幅)
ストロークの幅を設定します。
void
setTag(オブジェクト タグ)
円のタグを設定します。
void
setVisible(ブール値を表示)
円の公開設定を指定します。
void
setZIndex(浮動小数点数の zIndex)
zIndex を設定します。

継承されたメソッドの概要

パブリック メソッド

public LatLng getCenter ()

中心を LatLng として返します。

戻り値
  • LatLng としての地理的中心。

public int getFillColor ()

この円の塗りつぶし色を返します。

戻り値
  • 円の塗りつぶしの色(ARV 形式)。

公開 文字列 getId ()

この円の ID を取得します。ID は、地図上のすべての円の中で一意です。

public double getRadius ()

円の半径をメートル単位で返します。

戻り値
  • 半径(メートル単位)。

public int getStrokeColor ()

ストロークの色を返します。

戻り値
  • 円の色(ARB 形式)。

public List<PatternItem> getStrokePattern ()

この円の輪郭のストローク パターンを返します。

戻り値
  • ストロークのパターン。

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)

LatLng を使用して中心を設定します。

デフォルト値がないため、中心を null にすることはできません。

パラメータ
中央 円の地理的中心。LatLng として指定します。
スロー値
NullPointerException センターが null の場合

public void setClickable (ブール値のクリック可能)

円のクリック可能性を設定します。円がクリック可能な場合、ユーザーが円をクリックすると、アプリは GoogleMap.OnCircleClickListener に通知を受け取ります。イベント リスナーは setOnCircleClickListener(GoogleMap.OnCircleClickListener) を介して登録されます。

パラメータ
クリックできます 円の新しいクリック設定。

public void setFillColor (int color)

塗りつぶしの色を設定します。

塗りつぶしの色は、円内の色で、Color で指定された整数形式で示されます。TRANSPARENT を使用すると、塗りつぶしは描画されません。

パラメータ
Color 形式の色。

public void setRadius (double radius)

半径をメートル単位で設定します。

半径は 0 以上の値にしてください。

パラメータ
半径 半径(メートル単位)。
スロー値
IllegalArgumentException 半径が負の場合

public void setStrokeColor (int color)

ストロークの色を設定します。

ストローク色は、この円の輪郭の色です。Color で指定された整数形式で示されます。TRANSPARENT が使用されている場合、輪郭は描画されません。

パラメータ
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 値。