を拡張
ポリラインは点のリストで、連続する点の間に線分が描画されます。 ポリラインには次のプロパティがあります。
- ポイント数
- 線の頂点。線分は、連続する点の間に描画されます。ポリラインは、 デフォルトで閉じていません。閉じたポリラインを形成するには、始点と終点を 同じです
- 幅
- 線セグメントの幅(画面のピクセル数)。幅は一定で、カメラの 適用できます。デフォルト値は 10 です。
- 色
- ARGB 形式の線分の色(
Color
と同じ形式)。 デフォルト値は黒(0xff000000
)です。 - 開始/終了キャップ
- ポリラインの始点または終点で使用するシェイプを定義します。サポートされているキャップのタイプ:
ButtCap
、SquareCap
、RoundCap
(単色のストローク パターンに適用)CustomCap
(すべてのストローク パターンに適用)。start と end の両方のデフォルト:ButtCap
。 - ジョイントのタイプ
- ジョイントタイプは、隣接する線分を結合するときに使用するシェイプを定義します。
開始点と終了点を除く、ポリラインの頂点を指定します。
JointType
を表示: ジョイント タイプです。デフォルト値はDEFAULT
です。 - ストロークのパターン
- ソリッド(デフォルト、
null
で表される)、または一連のPatternItem
オブジェクト 線に沿って繰り返します。使用可能なPatternItem
タイプ:Gap
( ギャップの長さ(ピクセル単位)、Dash
(ラインの幅と破線の長さ(ピクセル単位)で定義)、およびDot
(線を中心とする円形、線の幅(ピクセル単位)で定義される直径)。 - Z インデックス
- このタイル オーバーレイが他のオーバーレイ(
GroundOverlay
、TileOverlay
、Circle
、Polygon
秒。ただし、Marker
)。Z-Index の大きいオーバーレイが、小さい Z-Index のオーバーレイの上に描画される 使用できます。同じ Z-Index のオーバーレイの順序は任意です。デフォルトの zIndex は 0. - 視程
- ポリラインを表示するか非表示にするか、つまり地図上に描画するかどうかを指定します。「
非表示のポリラインは描画されませんが、他のすべてのプロパティが保持されます。デフォルトは
true
、すなわち表示。 - 測地線ステータス
- ポリラインの線分を測地線として描画するか、 直線を描画します測地線は、2 つのレイヤ間の最短パスです。 地表上のポイントを表します。測地線曲線は、地球が 球体
- クリックされやすさ
- ユーザーがポリラインをクリックしたときに呼び出されるイベントを処理するには、このプロパティを
true
。この値はいつでも変更できます。デフォルトはfalse
です。もし プロパティがtrue
に設定されている場合、アプリはsetOnPolylineClickListener(GoogleMap.OnPolylineClickListener)
を通じて登録されたGoogleMap.OnPolylineClickListener
に通知を受け取ります。 - タグ
- ポリラインに関連付けられた
Object
。たとえば、Object
には、 ポリラインが表す内容に関するデータを返します。これは、個別のMap<Polyline, Object>
を保存するよりも簡単です。別の例として、String
ID を データセットから抽出したデータですGoogle Maps SDK for Android では、 このプロパティが書き込まれます。 - スパン
- このポリラインのレンダリングに使用されるさまざまなスタイルのスパンを定義します。こちらの
プロパティを使用して、異なる
StrokeStyle
を持つポリラインを ポリラインを作成します。
このクラスのメソッドは、Android UI スレッドで呼び出す必要があります。そうでない場合は、実行時に IllegalStateException
がスローされます。
例
GoogleMap map;
// ... get a map.
// Add a thin red line from London to New York.
Polyline line = map.addPolyline(new PolylineOptions()
.add(new LatLng(51.5, -0.1), new LatLng(40.7, -74.0))
.width(5)
.color(Color.RED));
デベロッパー ガイド
詳しくは、シェイプのデベロッパー向けドキュメントをご覧ください。 ご覧ください
パブリック メソッドの概要
boolean | |
int |
getColor()
このポリラインの色を取得します。
|
上限 |
getEndCap()
このポリラインの終点頂点のキャップを取得します。
|
文字列 |
getId()
このポリラインの ID を取得します。
|
int |
getJointType()
開始頂点と終了頂点を除く、ポリラインのすべての頂点で使用されるジョイント タイプを取得します。
|
List<PatternItem> |
getPattern()
このポリラインのストローク パターンを取得します。
|
List<LatLng> |
getPoints()
このポリラインの現時点における頂点のスナップショットを返します。
|
上限 |
getStartCap()
このポリラインの始点の頂点のキャップを取得します。
|
オブジェクト |
getTag()
ポリラインのタグを取得します。
|
float |
getWidth()
このポリラインの幅を取得します。
|
float |
getZIndex()
このポリラインの zIndex を取得します。
|
int |
hashCode()
|
boolean |
isClickable()
ポリラインのクリック可能性を取得します。
|
boolean |
isGeodesic()
線の各セグメントが測地線として描画されるかどうかを取得します。
|
boolean |
isVisible()
このポリラインの公開設定を取得します。
|
void |
remove()
地図からこのポリラインを削除します。
|
void |
setClickable(ブール値のクリック可能)
ポリラインのクリック可能性を設定します。
|
void |
setColor(int color)
このポリラインの色を設定します。
|
void | |
void |
setGeodesic(boolean geodesic)
線の各セグメントを測地線として描画するかどうかを設定します。
|
void |
setJointType(intJointType)
開始頂点と終了頂点を除くすべてのポリラインの頂点のジョイント タイプを設定します。
|
void | |
void | |
void | |
void | |
void |
setTag(オブジェクト タグ)
ポリラインのタグを設定します。
|
void |
setVisible(boolean visible)
このポリラインの表示 / 非表示を設定します。
|
void |
setWidth(浮動小数点数の幅)
このポリラインの幅を設定します。
|
void |
setZIndex(浮動小数点 zIndex)
このポリラインの zIndex を設定します。
|
継承されたメソッドの概要
パブリック メソッド
<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 次と等しい (オブジェクト その他)
<ph type="x-smartling-placeholder"></ph> 一般公開 整数 getColor ()
このポリラインの色を取得します。
戻り値
- ARGB 形式で色を指定します。
<ph type="x-smartling-placeholder"></ph> 一般公開 上限 をご覧ください。 getEndCap ()
このポリラインの終点頂点のキャップを取得します。
戻り値
- 使用します。
<ph type="x-smartling-placeholder"></ph> 一般公開 文字列 getId ()
このポリラインの ID を取得します。ID は地図上のすべてのポリラインの中で一意です。
戻り値
- このポリラインの ID。
<ph type="x-smartling-placeholder"></ph> 一般公開 整数 getJointType ()
開始頂点と終了頂点を除く、ポリラインのすべての頂点で使用されるジョイント タイプを取得します。詳しくは、
JointType
: 指定可能な値。
戻り値
- 結合タイプを指定します
<ph type="x-smartling-placeholder"></ph> 一般公開 List<PatternItem> のリスト をご覧ください。 getPattern ()
このポリラインのストローク パターンを取得します。
戻り値
- パターンを認識できます。
<ph type="x-smartling-placeholder"></ph> 一般公開 List<LatLng> をご覧ください。 getPoints ()
このポリラインの現時点における頂点のスナップショットを返します。返されるリストはコピーです
ポリラインの頂点を変更しても、これに反映されません
このリストに変更がポリラインには反映されません。地図の頂点を変更するには、
ポリラインの場合は、setPoints(List)
を呼び出します。
<ph type="x-smartling-placeholder"></ph> 一般公開 上限 をご覧ください。 getStartCap ()
このポリラインの始点の頂点のキャップを取得します。
戻り値
- 設定します。
<ph type="x-smartling-placeholder"></ph> 一般公開 オブジェクト getTag ()
ポリラインのタグを取得します。
戻り値
- タグが
setTag
に設定されている場合は、タグ。タグが設定されていない場合はnull
。
<ph type="x-smartling-placeholder"></ph> 一般公開 浮動小数点数 getWidth ()
このポリラインの幅を取得します。
戻り値
- 画面ピクセルの幅。
<ph type="x-smartling-placeholder"></ph> 一般公開 浮動小数点数 getZIndex ()
このポリラインの zIndex を取得します。
戻り値
- ポリラインの zIndex
<ph type="x-smartling-placeholder"></ph> 一般公開 整数 hashCode ()
<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 isClickable ()
ポリラインのクリック可能性を取得します。ポリラインがクリック可能な場合、アプリは
通知が GoogleMap.OnPolylineClickListener
に送られます。この通知は、
ポリライン。イベント リスナーは setOnPolylineClickListener(GoogleMap.OnPolylineClickListener)
を通じて登録されます。
戻り値
- ポリラインがクリック可能な場合は
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.OnPolylineClickListener
に送られます。この通知は、
ポリライン。イベント リスナーは setOnPolylineClickListener(GoogleMap.OnPolylineClickListener)
を通じて登録されます。
パラメータ
クリック可能 | ポリラインの新しいクリック可能性設定。 |
---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setColor (int カラー)
このポリラインの色を設定します。
パラメータ
色 | ARGB 形式の色 |
---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setEndCap (Cap endCap)
このポリラインの終点頂点にキャップを設定します。デフォルトのエンドキャップは ButtCap
です。
パラメータ
endCap | 使用します。null にすることはできません。
|
---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setGeodesic (ブール値の測地線)
線の各セグメントを測地線として描画するかどうかを設定します。
パラメータ
geodesic | true の場合、各セグメントは測地線として描画されます。false の場合、
各線分はメルカトル図法上の直線として描画されます。
|
---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setJointType (intJoinType)
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setPattern (List<PatternItem> パターン)
ポリラインのストローク パターンを設定します。デフォルトのストローク パターンは単色で、
null
。
パラメータ
パターン | パターンを認識できます。 |
---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setPoints (リスト <LatLng> ポイント)
このポリラインの地点を設定します。このメソッドはポイントのコピーを取得するため、
points
へのミューテーションはこのポリラインには影響を与えません。
パラメータ
ポイント | ポリラインの頂点である LatLng のリスト。
|
---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setSpans (List<StyleSpan> スパン)
ポリラインのスパンを設定します。
パラメータ
スパン |
---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setStartCap (Cap startCap)
このポリラインの始点の頂点にキャップを設定します。デフォルトの開始上限は ButtCap
です。
パラメータ
startCap | 設定します。null にすることはできません。
|
---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setTag (オブジェクト タグ)
ポリラインのタグを設定します。
このプロパティを使用して、任意の Object
をこのポリラインに関連付けることができます。対象
たとえば Object
には、ポリラインが表す内容に関するデータを含めることができます。こちらの方が簡単
Map<Polyline, 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> 一般公開 無効 setWidth (浮動小数点数の幅)
このポリラインの幅を設定します。
パラメータ
幅 | 画面の幅(ピクセル) |
---|
<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setZIndex (浮動小数点数 zIndex)
このポリラインの zIndex を設定します。zIndice が高いポリラインは、 低くなります。
パラメータ
zIndex | このポリラインの zIndex です。 |
---|