Circle

地表面上の円（球面キャップ）。

円には次の特性があります。

中心

円の中心は 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));
 

円が北極または南極のいずれかを含む場合、現在の地図レンダラでは円の塗りつぶしを描画できません。ただし、枠線は正しく描画されます。

デベロッパー ガイド

詳しくは、シェイプに関するデベロッパー ガイドをご覧ください。