を拡張
地表面の円(球面キャップ)。
円には次のような特性があります。
- 中央揃え
- 円の中心は
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>
を保存するよりも簡単です。別の例として、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 | |
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 値。 |
---|