を拡張
地表面の円(球面キャップ)。
円には次のような特性があります。
- 中央揃え
- 円の中心は
LatLngとして指定されます。 - 半径
- 円の半径(メートル単位)。0 以上の値を指定してください。
- ストロークの幅
- 円の輪郭の幅(画面のピクセル数)。幅は一定で独立している カメラのズームレベルのデフォルト値は 10 です。
- ストロークの色
- ARGB 形式の円の枠線の色。
Colorと同じ形式です。デフォルト値は黒(0xff000000)です。 - ストロークのパターン
- ソリッド(デフォルト、
nullで表される)、または一連のPatternItemオブジェクト 円の輪郭に沿って繰り返します。利用可能なPatternItemタイプ:Gap(ピクセル単位のギャップ長で定義)、Dash(ストローク幅と点線の長さで定義) ピクセル)とDot(円形、円の輪郭を中心とする、直径 (ピクセル単位のストローク幅)。 - 塗りつぶしの色
- 円の塗りつぶしの色は ARGB 形式(
Colorで使用される形式と同じ)です。デフォルト値は透明(0x00000000)です。 - Z インデックス
- このタイル オーバーレイが他のオーバーレイ(
GroundOverlay、TileOverlay、Polyline、Polygonですが、Markerではありません)。Z-Index の大きいオーバーレイが、小さい Z-Index のオーバーレイの上に描画される 使用できます。同じ Z-Index のオーバーレイの順序は任意です。デフォルトの zIndex は 0. - 視程
- 円を表示するか非表示にするか、つまり地図上に描画されるかどうかを指定します。「
非表示の円は描画されませんが、他のすべてのプロパティが保持されます。デフォルトは
true、すなわち表示。 - タグ
- サークルに関連付けられた
Object。たとえば、Objectには、 円が表す内容に関するデータです。これは、個別のMap<Circle, Object>を保存するよりも簡単です。別の例として、StringID を データセットから抽出したデータです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 | |
| int |
getFillColor()
この円の塗りつぶしの色を返します。
|
| 文字列 |
getId()
このサークルの ID を取得します。
|
| 倍精度 |
getRadius()
円の半径をメートル単位で返します。
|
| int |
getStrokeColor()
ストロークの色を返します。
|
| List<PatternItem> |
getStrokePattern()
この円の枠線のストローク パターンを返します。
|
| float |
getStrokeWidth()
ストロークの幅を返します。
|
| オブジェクト |
getTag()
円のタグを取得します。
|
| float |
getZIndex()
zIndex を返します。
|
| boolean |
isClickable()
円のクリック可能性を取得します。
|
| boolean |
isVisible()
円が表示されているかどうかを確認します。
|
| void |
remove()
地図からこの円を削除します。
|
| void | |
| void |
setClickable(ブール値のクリック可能)
円のクリック可能性を設定します。
|
| void |
setFillColor(int color)
塗りつぶしの色を設定します。
|
| void |
setRadius(二重半径)
半径をメートル単位で設定します。
|
| void |
setStrokeColor(int の色)
ストロークの色を設定します。
|
| void | |
| void |
setStrokeWidth(浮動小数点数の幅)
ストロークの幅を設定します。
|
| void |
setTag(オブジェクト タグ)
円のタグを設定します。
|
| void |
setVisible(boolean visible)
円の表示 / 非表示を設定します。
|
| void |
setZIndex(浮動小数点 zIndex)
zIndex を設定します。
|
継承されたメソッドの概要
パブリック メソッド
<ph type="x-smartling-placeholder"></ph> 一般公開 LatLng をご覧ください。 getCenter ()
<ph type="x-smartling-placeholder"></ph> 一般公開 整数 getFillColor ()
この円の塗りつぶしの色を返します。
戻り値
- 円の塗りつぶしの色(ARRGB 形式)。
<ph type="x-smartling-placeholder"></ph> 一般公開 文字列 getId ()
このサークルの ID を取得します。ID は地図上のすべての円で一意になります。
<ph type="x-smartling-placeholder"></ph> 一般公開 倍精度 getRadius ()
円の半径をメートル単位で返します。
戻り値
- 半径(メートル単位)。
<ph type="x-smartling-placeholder"></ph> 一般公開 整数 getStrokeColor ()
ストロークの色を返します。
戻り値
- 円の色(ARRGB 形式)。
<ph type="x-smartling-placeholder"></ph> 一般公開 List<PatternItem> のリスト をご覧ください。 getStrokePattern ()
この円の枠線のストローク パターンを返します。
戻り値
- パターンを認識できます。
<ph type="x-smartling-placeholder"></ph> 一般公開 浮動小数点数 getStrokeWidth ()
ストロークの幅を返します。
戻り値
- 画面のピクセル幅。
<ph type="x-smartling-placeholder"></ph> 一般公開 オブジェクト getTag ()
円のタグを取得します。
戻り値
- タグが
setTagに設定されている場合は、タグ。タグが設定されていない場合はnull。
<ph type="x-smartling-placeholder"></ph> 一般公開 浮動小数点数 getZIndex ()
zIndex を返します。
戻り値
- この円の zIndex です。
<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 isClickable ()
円のクリック可能性を取得します。円がクリック可能な場合、アプリは
通知が GoogleMap.OnCircleClickListener に送信されます。
イベント リスナーは setOnCircleClickListener(GoogleMap.OnCircleClickListener) を通じて登録されます。
戻り値
- 円がクリック可能な場合は
true、クリックできない場合はfalse。
<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 isVisible ()
円が表示されているかどうかを確認します。
戻り値
- 円が表示されている場合は
true、非表示の場合はfalse。
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 削除 ()
地図からこの円を削除します。円を削除すると、そのすべての円の メソッドが定義されていません。
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setCenter (LatLng 中心)
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setClickable (クリック可能ブール値)
円のクリック可能性を設定します。円がクリック可能な場合、アプリは
通知が GoogleMap.OnCircleClickListener に送信されます。
イベント リスナーは setOnCircleClickListener(GoogleMap.OnCircleClickListener) を通じて登録されます。
パラメータ
| クリック可能 | 円のクリック可能性に関する新しい設定。 |
|---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setFillColor (int カラー)
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setRadius (二重半径)
半径をメートル単位で設定します。
半径には 0 以上の値を指定してください。
パラメータ
| 半径 | 半径(メートル単位)。 |
|---|
例外
| IllegalArgumentException | 半径が負の値の場合 |
|---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setStrokeColor (int カラー)
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setStrokePattern (List<PatternItem> パターン)
円の枠線のストローク パターンを設定します。デフォルトのストロークパターンは単色です。
null で表します。
パラメータ
| パターン | パターンを認識できます。 |
|---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setStrokeWidth (浮動小数点数の幅)
ストロークの幅を設定します。
ストロークの幅は、円の輪郭の幅(画面のピクセル数)です。ゼロまたは 大きくなりますゼロの場合、枠線は描画されません。デフォルト値は 10 です。
パラメータ
| 幅 | ストロークの幅(画面のピクセル数)。 |
|---|
例外
| IllegalArgumentException | 幅が負の場合 |
|---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setTag (オブジェクト タグ)
円のタグを設定します。
このプロパティを使用して、任意の Object をこの円に関連付けることができます。対象
たとえば Object には、円が表す内容に関するデータを含めることができます。こちらの方が簡単
Map<Circle, Object> を格納するよりも効率的です。別の例として、1 つのテーブルに
String データセットの ID に対応する ID。Google Maps SDK for Android でもない
読み書きできません。責任を持って setTag(null) を呼び出して、
アプリのメモリリークを防止できます。
パラメータ
| タグ | null の場合、タグはクリアされます。 |
|---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setVisible (ブール値表示)
円の表示 / 非表示を設定します。
この円が表示されていない場合、円は描画されません。その他の状態はすべて保持されます。 円はデフォルトで表示されます。
パラメータ
| 表示 | true: このサークルを公開します。false して非表示にします。
|
|---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setZIndex (浮動小数点数 zIndex)
zIndex を設定します。
zIndice が大きいオーバーレイ(円など)は、zIndice が低いオーバーレイより上に描画されます。
パラメータ
| zIndex | zIndex 値。 |
|---|