を拡張
地表面上のポリゴン。多角形は凸面と凹面のどちらかで、180 度の範囲に設定できます。 穴が埋められていないことがあります。次のプロパティがあります。
- アウトライン
- 枠線は、時計回りまたは反時計回りの頂点のリストで指定します。これは、 始点と終点が一致する必要はありません。そうでない場合、ポリゴンは 自動的に閉じます。線分は、短い方の連続するポイントの間に描画されます。 水平方向(東または西)を表します。
- ホール
- 穴とは、ポリゴンの内部で塗りつぶされていない領域のことです。穴は 概要と同じ方法で指定できます。穴は枠線内に完全に収まっている必要があります。複数 穴は指定できますが、重なり合うホールはサポートされていません。
- ストロークの幅
- 線セグメントの幅(画面のピクセル数)。幅は一定で、カメラの 適用できます。デフォルト値は 10 です。
- ストロークの色
- ARGB 形式の線分の色(
Color
と同じ形式)。 デフォルト値は黒(0xff000000
)です。 - ストロークジョイントのタイプ
- ジョイントタイプは、隣接する線分を結合するときに使用するシェイプを定義します。
ポリゴンの枠線の頂点を指定します。サポートされているジョイントタイプについては、
JointType
をご覧ください。「 デフォルト値はDEFAULT
です。 - ストロークのパターン
- ソリッド(デフォルト、
null
で表される)、または一連のPatternItem
オブジェクト ポリゴンのアウトラインに沿って繰り返します。使用可能なPatternItem
タイプ:Gap
(ピクセル単位のギャップ長で定義)、Dash
(ストローク幅と破線で定義) 長さ(ピクセル単位)とDot
(円形、ポリゴンの輪郭を中心とする直径) (ピクセル単位のストローク幅で定義されます)。 - 塗りつぶしの色
Color
で使用されているのと同じ ARGB 形式の塗りつぶし色。「 デフォルト値は透明(0x00000000
)です。ポリゴン ジオメトリを指定していない場合、 正しく設定されていない場合(上の「枠線」と「穴」を参照)、塗りつぶしは描画されません。- Z インデックス
- 他のオーバーレイ(
Polyline
、Circle
、GroundOverlay
、TileOverlay
など)に対してこのポリゴンが描画される順序。ただし、Marker
秒。Z-Index の大きいオーバーレイが、小さい Z-Index のオーバーレイの上に描画される 使用できます。同じ Z-Index 値を持つオーバーレイの順序は任意です。デフォルトは 0. - 視程
- ポリゴンの表示 / 非表示、つまり地図上に描画されるかどうかを指定します。「
非表示のポリゴンは描画されませんが、他のすべてのプロパティを保持します。デフォルトは
true
、すなわち表示。 - 測地線ステータス
- ポリゴンのセグメントを測地線として描画するかどうかを指定します。 直線を描画します測地線は、2 つのレイヤ間の最短パスです。 地表上のポイントを表します。測地線曲線は、地球が 球体
- クリックされやすさ
- ユーザーがポリゴンをクリックしたときに起動されるイベントを処理する場合は、このプロパティを
true
。この値はいつでも変更できます。デフォルトはfalse
です。もし プロパティがtrue
に設定されている場合、アプリはsetOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
を通じて登録されたGoogleMap.OnPolygonClickListener
に通知を受け取ります。 - タグ
- ポリゴンに関連付けられた
Object
。たとえば、Object
には、 ポリゴンが表す内容に関するデータを出力できます。これは、個別のMap<Polygon, Object>
を保存するよりも簡単です。別の例として、String
ID を データセットから抽出したデータですGoogle Maps SDK for Android では、 このプロパティが書き込まれます。
このクラスのメソッドは、Android UI スレッドで呼び出す必要があります。そうでない場合は、実行時に IllegalStateException
がスローされます。
例
GoogleMap map;
// ... get a map.
// Add a triangle in the Gulf of Guinea
Polygon polygon = map.addPolygon(new PolygonOptions()
.add(new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5), new LatLng(0, 0))
.strokeColor(Color.RED)
.fillColor(Color.BLUE));
デベロッパー ガイド
詳しくは、シェイプのデベロッパー向けドキュメントをご覧ください。 ご覧ください
パブリック メソッドの概要
boolean | |
int |
getFillColor()
このポリゴンの塗りつぶしの色を取得します。
|
List<List<LatLng>> |
getHoles()
この時点のポリゴンの穴のスナップショットを返します。
|
文字列 |
getId()
このポリゴンの ID を取得します。
|
List<LatLng> |
getPoints()
このポリゴンの現時点での頂点のスナップショットを返します。
|
int |
getStrokeColor()
このポリゴンのストロークの色を取得します。
|
int |
getStrokeJointType()
ポリゴンの枠線のすべての頂点で使用されるストローク ジョイント タイプを取得します。
|
List<PatternItem> |
getStrokePattern()
このポリゴンの枠線のストローク パターンを取得します。
|
float |
getStrokeWidth()
このポリゴンのストローク幅を取得します。
|
オブジェクト |
getTag()
ポリゴンのタグを取得します。
|
float |
getZIndex()
このポリゴンの zIndex を取得します。
|
int |
hashCode()
|
boolean |
isClickable()
ポリゴンのクリック可能性を取得します。
|
boolean |
isGeodesic()
線の各セグメントが測地線として描画されるかどうかを取得します。
|
boolean |
isVisible()
このポリゴンの公開設定を取得します。
|
void |
remove()
地図からポリゴンを除去します。
|
void |
setClickable(ブール値のクリック可能)
ポリゴンのクリック可能性を設定します。
|
void |
setFillColor(int color)
このポリゴンの塗りつぶしの色を設定します。
|
void |
setGeodesic(boolean geodesic)
線の各セグメントを測地線として描画するかどうかを設定します。
|
void | |
void | |
void |
setStrokeColor(int の色)
このポリゴンのストロークの色を設定します。
|
void |
setStrokeJointType(intjoinType)
ポリゴンの枠線のすべての頂点にジョイント タイプを設定します。
|
void | |
void |
setStrokeWidth(浮動小数点数の幅)
このポリゴンのストローク幅を設定します。
|
void |
setTag(オブジェクト タグ)
ポリゴンのタグを設定します。
|
void |
setVisible(boolean visible)
このポリゴンの表示 / 非表示を設定します。
|
void |
setZIndex(浮動小数点 zIndex)
このポリゴンの zIndex を設定します。
|
継承されたメソッドの概要
パブリック メソッド
<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 等しい (オブジェクト その他)
<ph type="x-smartling-placeholder"></ph> 一般公開 整数 getFillColor ()
このポリゴンの塗りつぶしの色を取得します。
戻り値
- ARGB 形式で色を指定します。
<ph type="x-smartling-placeholder"></ph> 一般公開 List<List<LatLng>> をご覧ください。 getHoles ()
この時点のポリゴンの穴のスナップショットを返します。返されるリストは、 ポリゴンのホールに変更を加えてもこのリストには反映されません。 このリストへの変更はポリゴンに反映されます。
<ph type="x-smartling-placeholder"></ph> 一般公開 文字列 getId ()
このポリゴンの ID を取得します。ID は地図上のすべてのポリゴンの中で一意です。
<ph type="x-smartling-placeholder"></ph> 一般公開 List<LatLng> をご覧ください。 getPoints ()
このポリゴンの現時点での頂点のスナップショットを返します。返されるリストはコピーです
そのため、ポリゴンの頂点を変更しても、これには反映されません。
変更もポリゴンには反映されません。地図の頂点を変更するには、
ポリゴンの場合は、setPoints(List)
を呼び出します。
<ph type="x-smartling-placeholder"></ph> 一般公開 整数 getStrokeColor ()
このポリゴンのストロークの色を取得します。
戻り値
- ARGB 形式で色を指定します。
<ph type="x-smartling-placeholder"></ph> 一般公開 整数 getStrokeJointType ()
ポリゴンの枠線のすべての頂点で使用されるストローク ジョイント タイプを取得します。JointType
を参照
をご覧ください。
戻り値
- ストロークジョイントのタイプを指定します
<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> 一般公開 整数 hashCode ()
<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 isClickable ()
ポリゴンのクリック可能性を取得します。ポリゴンがクリック可能な場合、アプリは
ユーザーがポリゴンをクリックしたときに GoogleMap.OnPolygonClickListener
に通知が送信されます。
イベント リスナーは setOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
を通じて登録されます。
戻り値
- ポリゴンがクリック可能な場合は
true
。それ以外の場合はfalse
を返します。
<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 isGeodesic ()
線の各セグメントが測地線として描画されるかどうかを取得します。
戻り値
- 各セグメントが測地線として描画される場合は
true
。各セグメントが次の場合はfalse
メルカトル図法上の直線として描画されます
<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 isVisible ()
このポリゴンの公開設定を取得します。
戻り値
- 設定します。
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 削除 ()
地図からポリゴンを除去します。ポリゴンを削除すると、そのすべての対象物の動作は メソッドが定義されていません。
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setClickable (クリック可能ブール値)
ポリゴンのクリック可能性を設定します。ポリゴンがクリック可能な場合、アプリは
ユーザーがポリゴンをクリックしたときに GoogleMap.OnPolygonClickListener
に通知が送信されます。
イベント リスナーは setOnPolygonClickListener(GoogleMap.OnPolygonClickListener)
を通じて登録されます。
パラメータ
クリック可能 | ポリゴンの新しいクリック可能性設定。 |
---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setFillColor (int カラー)
このポリゴンの塗りつぶしの色を設定します。
パラメータ
色 | ARGB 形式の色 |
---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setGeodesic (ブール値の測地線)
線の各セグメントを測地線として描画するかどうかを設定します。
パラメータ
geodesic | true の場合、各セグメントは測地線として描画されます。false の場合、
各線分はメルカトル図法上の直線として描画されます。
|
---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setHoles (List<? extends List<LatLng>> のホール)
このポリゴンのホールを設定します。このメソッドはホールのコピーを取得するため、
holes
までは、このポリゴンには作用しません。
パラメータ
holes | ホールのリスト。ここで、ホールは LatLng のリストです。
|
---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setPoints (リスト <LatLng> ポイント)
このポリゴンのポイントを設定します。このメソッドはポイントのコピーを取得するため、
points
に対するミューテーションはこのポリゴンには影響しません。
パラメータ
ポイント | ポリゴンの頂点である LatLng のリスト。
|
---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setStrokeColor (int カラー)
このポリゴンのストロークの色を設定します。
パラメータ
色 | ARGB 形式の色 |
---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setStrokeJointType (intJoinType)
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setStrokePattern (List<PatternItem> パターン)
ポリゴンの枠線のストローク パターンを設定します。デフォルトのストロークパターンは単色です。
null
で表します。
パラメータ
パターン | パターンを認識できます。 |
---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setStrokeWidth (浮動小数点数の幅)
このポリゴンのストローク幅を設定します。
パラメータ
幅 | 幅(ディスプレイ ピクセル)。 |
---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setTag (オブジェクト タグ)
ポリゴンのタグを設定します。
このプロパティを使用して、任意の Object
をこのポリゴンに関連付けることができます。対象
たとえば Object
には、ポリゴンが表す内容に関するデータを含めることができます。こちらの方が簡単
Map<Polygon, 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 です。 |
---|